项目简介

YAMCP (YAM-C-P) 是一个命令行工具，旨在简化 Model Context Protocol (MCP) 服务器的管理和使用。它允许您连接到本地或远程的多个 MCP 服务器，并将它们的能力（如工具、Prompt 模板）聚合到一个统一的“工作区”（Workspace，也称为 YAM）。这个工作区本身作为一个 MCP 服务器（称为 Gateway）提供给 AI 应用程序（如 Cursor、Claude 等）使用。

使用 YAMCP，您可以：

• 连接并管理不同的 MCP 服务器。
• 创建工作区，将多个服务器的能力按特定用途（如编程、设计）或按 AI 应用分组。
• 通过一个统一的接口（YAMCP Gateway）向 AI 应用提供所有工作区内服务器的能力。
• 集中管理服务器配置和通信日志。

主要功能点

• MCP 服务器管理： 添加、列出、移除和导入 MCP 服务器的连接配置。
• 工作区管理： 创建、列出、编辑、扫描和删除工作区，每个工作区包含选定的 MCP 服务器集合。
• Gateway 运行： 启动 YAMCP Gateway，加载指定工作区内的服务器，并作为一个统一的 MCP 服务器接口监听 AI 应用的请求。
• 日志查看： 提供统一的日志目录，方便调试和监控。
• 能力聚合与路由： Gateway 会从所有配置的服务器收集工具和 Prompt 列表，并根据 AI 应用的请求将调用路由到正确的下游服务器。

安装步骤

1. 确保您的系统已安装 Node.js (建议最新 LTS 版本) 和 npm。

2. 打开终端或命令行界面。

3. 运行以下命令全局安装 YAMCP：

   npm install -g yamcp
   

   或者使用 npx 直接运行（不需要全局安装）：

   npx yamcp [command] [subcommand]
   

服务器配置

YAMCP 本身是作为一个 MCP Gateway 运行的服务器。AI 应用需要连接到这个 Gateway。YAMCP Gateway 主要通过 Stdio 协议与 AI 应用通信。

AI 应用通常通过配置要启动的命令 (command) 及其参数 (args) 来连接 Stdio MCP 服务器。

要连接到运行特定工作区的 YAMCP Gateway，您需要将 AI 应用配置为启动以下命令：

• 命令 (command): 'yamcp'
• 参数 (args): '["run", "<工作区名称>"]'

这里的 '<工作区名称>' 是您在 YAMCP 中创建的工作区的名称。

例如，如果您创建了一个名为 'my-coding-workspace' 的工作区，您需要在 AI 应用的 MCP 服务器配置中指定：

• 命令: 'yamcp'
• 参数: '["run", "my-coding-workspace"]'
• 服务器名称: 'yamcp_gateway' (这是 YAMCP Gateway 默认对外宣称的名称)

（请注意：AI 应用的具体配置界面和格式因应用而异，请参考您的 AI 应用文档了解如何添加 MCP 服务器配置。）

基本使用方法

1. 添加或导入 MCP 服务器：

   • 手动添加：运行 'yamcp server add' 并按照提示操作。
   • 从文件导入：准备一个 JSON 配置文件，其中包含您要添加的 MCP 服务器列表（格式请参考项目示例或文档），然后运行 'yamcp server import <配置文件路径>'。

2. 创建工作区：

   • 运行 'yamcp yam create' 并按照提示选择要包含在工作区中的服务器，并为工作区命名。

3. 运行 Gateway：

   • 运行 'yamcp run <工作区名称>' 来启动 YAMCP Gateway，它将加载指定工作区中的服务器配置，并监听来自 AI 应用的 MCP 请求（通常通过 Stdio）。

4. 在 AI 应用中配置连接：

   • 打开您的 AI 应用程序，找到 MCP 服务器配置界面。
   • 添加一个新的 MCP 服务器，将其配置为启动 'yamcp' 命令，并传递 'run <工作区名称>' 作为参数。

5. 管理和查看：

   • 'yamcp server list': 列出所有已配置的 MCP 服务器。
   • 'yamcp yam list': 列出所有已创建的工作区。
   • 'yamcp log': 查看日志目录位置。