MCP Os

MCP-OS·模型上下文协议编排系统

让你的大型语言模型专注于解决任务，而不是在MCP的海洋中跋涉。

👉 查看中文版 README

______________________________________________________________________

✨ 项目愿景

随着 模型上下文协议（MCP） 生态系统爆炸，数百台MCP服务器造成了三个常见的麻烦：

MCP-OS 旨在：

*“以操作系统管理进程的方式管理MCP——按需加载，空闲时卸载。”*

______________________________________________________________________

🌟 当前阶段：MCP检索器（已完成✅)

1. 矢量检索 --嵌入任务描述并从向量索引中检索Top-k MCP。
2. 精简提示模板 --仅注射 *顶部K* MCP描述，平均节省约70%的提示令牌。
3. 可插拔后端 --默认值 openai/embeddings交换FAISS、Qdrant、Milvus等。

📖 详情请参阅 .

______________________________________________________________________

🛣️ 路线图

______________________________________________________________________

⚙️ 快速开始

1.克隆和安装

git clone https://github.com/your-org/mcp-os.git
cd mcp-os
npm install      # or npm / yarn

2.构建矢量索引

# Scan local / remote MCP metadata and create an index
npm run build:index --src ./mcp_list.json --out ./index

3.启动检索服务器

npm run start:retriever
# Default listens on 127.0.0.1:5500 (HTTP + SSE)

4.将其电汇至您的法学硕士/代理

// Example: Claude Desktop
{
  "mcpServers": {
    "mcp-os": {
      "command": "/absolute/path/to/mcp-os/bin/retriever.js"
    }
  }
}

或者调用REST端点：

curl -X POST http://localhost:5500/match \
  -H "Content-Type: application/json" \
  -d '{"task": "Scrape a web page and extract its title"}'

示例响应：

{
  "matches": [
    {
      "id": "web-scraper",
      "score": 0.89,
      "functions": ["fetchHtml", "querySelector"]
    }
  ]
}

______________________________________________________________________

📂 仓库的规划

mcp-os/
├─ packages/
│  ├─ retriever/        # Phase 1: vector retrieval
│  ├─ health-check/     # Phase 2: heartbeat daemon (WIP)
│  └─ runtime-manager/  # Phase 3: load/unload (planned)
├─ scripts/             # CLI helpers
├─ examples/            # Usage demos
└─ docs/                # Architecture & deep dives

______________________________________________________________________

🧩 MCP列表格式

mcp_list.json 描述MCP元数据：

{
  "web-scraper": {
    "name": "Web Scraper MCP",
    "description": "Fetches HTML and parses DOM.",
    "functions": ["fetchHtml", "querySelector"]
  },
  "calc": { ... }
}

______________________________________________________________________

❓ 常见问题解答

Retrieval quality is poor—how do I tune it?

• 增加 topK 以获得更高的召回率。
• 切换到更强的嵌入模型。
• 优化任务文本规范化规则。

How do I plug in my own vector store?

实施 VectorStore 接口： src/store/yourStore.ts.

______________________________________________________________________

🤝 贡献

1. 分叉 回购
2. 创建分支 feature/awesome-stuff
3. 打开PR并链接相关问题
4. 等待CI+审核🎉

______________________________________________________________________

📜 许可证

Apache许可证v2

______________________________________________________________________

🙏 致谢

• 这 模型上下文协议 开放规范社区
• MCP检查员 用于调试
• 所有提交问题或PR的人——谢谢！ ❤️