使用说明

项目简介

1MCP Agent (One MCP Agent) 是一个统一的 Model Context Protocol (MCP) 服务器，旨在简化 AI 助手与多个 MCP 服务器交互的配置和管理。它将多个独立的 MCP 服务器聚合到一个统一的接口之下，使得 LLM 客户端只需连接 1MCP Agent 即可访问所有后端 MCP 服务器的功能。

主要功能点

MCP 服务器聚合: 将多个 MCP 服务器整合为一个统一的接入点。
简化配置: 集中管理多个 MCP 服务器的配置，减少客户端配置的复杂性。
资源优化: 避免运行多个独立的 MCP 服务器实例，降低系统资源消耗。
标签过滤: 支持通过标签 (Tags) 对后端 MCP 服务器进行分类和过滤，允许客户端按需访问特定功能的服务器。
动态配置: 支持动态重载配置，无需重启服务器即可应用新的配置更改。
多协议支持: 支持 SSE (Server-Sent Events) 和 Stdio 两种传输协议，适应不同的应用场景。

安装步骤

安装 Node.js 和 npm 或 pnpm: 确保你的系统已安装 Node.js 和包管理器 npm 或 pnpm。
安装 1MCP Agent: 由于这是一个可执行的 npm 包，你可以直接使用 'npx' 命令运行，无需全局安装。

服务器配置

对于 MCP 客户端（如 Cursor、Cherry Studio 等），你需要配置连接到 1MCP Agent 服务器。配置的关键信息是 1MCP Agent 提供的服务器地址 (URL) 和传输类型 (type)。

以下是在 MCP 客户端配置文件 ('mcp.json' 或类似文件) 中配置 1MCP Agent 的示例：

{
  "mcpServers": {
    "1mcp": {
      "type": "http",
      "url": "http://localhost:3050/sse"
    }
  }
}

配置参数说明:

'server name': '"1mcp"' (可以自定义名称，用于在客户端中标识 1MCP Agent 服务器)
'type': '"http"' (指定传输类型为 HTTP SSE)
'url': '"http://localhost:3050/sse"' (1MCP Agent 服务器的 SSE 接口地址，默认情况下运行在 'http://localhost:3050/sse')

高级配置 - 标签过滤 (可选):

如果你的 1MCP Agent 配置了标签 (Tags) 来区分后端 MCP 服务器的功能，你可以在客户端连接 URL 中添加 'tags' 参数来过滤。例如，只连接具有 'network' 标签的服务器：

{
  "mcpServers": {
    "1mcp-network": {
      "type": "http",
      "url": "http://localhost:3050/sse?tags=network"
    }
  }
}

基本使用方法

启动 1MCP Agent 服务器: 打开终端，使用 'npx' 命令启动 1MCP Agent 服务器。
- 默认启动 (SSE 传输):
```
npx -y @1mcp/agent
```
  这将启动 1MCP Agent 服务器，默认使用 SSE 传输协议，监听 'http://localhost:3050/sse'。
- 使用 Stdio 传输启动:
```
npx -y @1mcp/agent --transport stdio
```
  这将使用 Stdio 传输协议启动服务器，适用于某些特定的客户端或场景。
- 指定配置文件启动: 你可以使用 '--config' 或 '-c' 参数指定一个配置文件路径，让 1MCP Agent 加载该配置文件中的 MCP 服务器列表。例如，使用 Claude Desktop 的配置文件：
```
npx -y @1mcp/agent --config ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
- 使用标签过滤启动 (Stdio 传输模式): 在 Stdio 模式下启动时，可以使用 '--tags' 或 '-g' 参数来指定 1MCP Agent 仅聚合包含特定标签的后端 MCP 服务器。例如，只启动具有 "network" 或 "filesystem" 标签的服务器：
```
npx -y @1mcp/agent --transport stdio --tags "network,filesystem"
```
配置 MCP 客户端: 根据你的 MCP 客户端 (如 Cursor, Cherry Studio) 的配置方法，添加或修改 MCP 服务器配置，指向 1MCP Agent 服务器的地址和端口。
连接和使用: 启动你的 MCP 客户端，它应该能够通过 1MCP Agent 连接到所有配置的后端 MCP 服务器，并开始使用资源 (Resources), 工具 (Tools), 和 Prompt 模板 (Prompts) 等功能。

注意事项

1MCP Agent 本身不提供资源、工具或 Prompt 模板，它只是一个聚合器，依赖于你配置的后端 MCP 服务器。
确保后端 MCP 服务器已正确配置并运行，1MCP Agent 才能成功聚合它们的功能。
可以通过查看 1MCP Agent 的日志输出 (终端或日志文件，取决于日志配置) 来诊断连接和配置问题。

关键词