🍠 YAMCP - A Model Context Workspace Manager

🍠 YAMCP - 模型上下文工作区管理器

YAMCP（YAM-C-P）是一款命令行工具，用于将 MCP 服务整理和管理为本地工作区。它可无缝连接多个本地或远程 MCP 服务，并将它们归入统一工作区，再作为另一个 MCP 服务（YAM）提供给 AI 应用。你可以根据特定功能创建专用工作区（例如用于编码、设计、研究等的 YAM 工作区），也可以根据使用这些服务的 AI 应用创建工作区（例如用于 Cursor、Claude、Windsurf 的 YAM），或进行其他组合。此外，它通过将所有服务通信日志集中存储，简化了 MCP 服务的监控和调试，无需再分别查阅各个 AI 客户端应用的日志。

导入并创建工作区

通过一份配置，将工作区中的所有捆绑服务连接到你的 AI 应用

🚀 快速开始

# Install YAMCP
npm install -g yamcp  # or use npx yamcp

# Import servers (choose one)
yamcp server import [config]    # import servers from config file (see src/example-servers.json for format)
yamcp server add                # or add manually

# create workspaces (e.g. a yam for coding, design, data, ...)
yamcp yam create

# Run workspace in your AI app
yamcp run <yam-workspace-name>

🔑 核心概念

• MCP 服务：提供模型上下文协议服务的远程或本地服务
• 工作区（YAM）：将 MCP 服务归组后共享给 AI 应用的集合（例如用于编码、写作、设计、魔法创作的工作区！）
• 网关：本地 MCP 服务，用于管理与工作区中已配置 MCP 服务的连接，并通过统一服务向 AI 应用的 MCP 客户端提供这些服务

借助 YAMCP，你可以：

• 创建工作区，按 AI 应用归组 MCP 服务（例如 Cursor、Claude、GitHub Copilot）
• 按工作流用途归组服务（例如软件开发、数据科学、技术写作）
• 将 AI 应用连接到单个网关，以访问工作区中的所有服务
• 通过统一界面管理和监控多个 MCP 服务连接
• 通过详细的日志记录和调试功能跟踪所有服务通信

顶级命令

yamcp [command] [subcommand] [flags]

可用的顶级命令：

• server - 管理 MCP 提供方
• yam - 管理工作区（YAM）
• run - 使用工作区运行网关
• log - 查看服务日志位置

---

🔧 MCP 服务管理命令

服务命令

yamcp server add      # Add a new MCP server (interactive)
yamcp server list     # List all configured servers and their status
yamcp server remove   # Remove a server configuration
yamcp server import   # Import server configurations from a JSON file

---

🍠 YAM 工作区管理命令

工作区命令

yamcp yam create      # Create a new workspace (interactive)
yamcp yam list        # List all workspaces or show specific workspace details
yamcp yam edit        # Modify an existing workspace configuration
yamcp yam scan            # Scan workspaces
yamcp yam delete          # Delete a workspace

运行时命令

yamcp run <yam-workspace-name>   # Start the gateway with specified workspace
yamcp log                    # View server communication logs

---

✅ 命令参考

命令	说明	示例
server add	添加新的 MCP 服务	yamcp server add
server list	列出已配置的服务	yamcp server list
server remove	移除服务	yamcp server remove [name]
server import	导入服务配置	yamcp server import [config]
yam create	创建工作区	yamcp yam create
yam list	列出工作区	yamcp yam list
yam list --name	显示工作区详情	yamcp yam list --name my-workspace
yam edit	编辑工作区	yamcp yam edit
yam scan	扫描工作区	yamcp yam scan [workspace-name]
yam delete	删除工作区	yamcp yam delete [workspace-name]
run	启动网关	yamcp run <workspace-name>
log	查看日志	yamcp log

---

🖥️ YAMCP UI（由 @eladcandroid 创建）

YAMCP UI 提供直观的 Web 界面，让你通过通用控制面板管理 MCP 服务和工作区。

# Run directly with npx (recommended)
npx yamcp-ui

# Or install globally
npm install -g yamcp-ui
yamcp-ui

完整文档请参阅项目仓库：https://github.com/eladcandroid/yamcp-ui。

🏗️ 系统架构

graph TB
    CLI[CLI Commands]
    GW[McpGateway]
    GS[GatewayServer]
    GR[GatewayRouter]
    LOG[Logger]
    STORE[(Store)]
    AI_APP[AI App]

    %% CLI Command Flow
    CLI -->|manages| STORE
    CLI -->|runs| GW

    %% Gateway Components
    GW -->|uses| GS
    GW -->|uses| GR
    GW -->|logs| LOG

    %% Server & Router
    GS -->|stdio transport| AI_APP
    GR -->|connects to| SERVERX
    GR -->|connects to| SERVERY

    %% Data Store
    STORE -->|loads config| GW

    %% External MCP Servers
    subgraph "Workspace Servers"
        SERVERX["Server x (Stdio)"]
        SERVERY["Server y (SSE)"]
    end
    %% Store Components
    subgraph "Configuration Store"
        PROVIDERS[(Provider Config)]
        WORKSPACES[(Workspace Config)]
    end
    STORE --- PROVIDERS
    STORE --- WORKSPACES

    classDef primary fill:#2374ab,stroke:#2374ab,color:#fff
    classDef secondary fill:#ff7e67,stroke:#ff7e67,color:#fff
    classDef store fill:#95b8d1,stroke:#95b8d1,color:#fff

    class GW,GS,GR primary
    class CLI,AI_APP secondary
    class STORE,PROVIDERS,WORKSPACES store

该图展示了 YAMCP 系统的主要组件：

• CLI Commands：用于管理服务和工作区的用户界面
• McpGateway：负责协调 Gateway Server 和 Router 的核心组件
• GatewayServer：通过 stdio 传输方式处理与 AI 应用的通信
• GatewayRouter：管理与已配置 MCP 服务的连接
• Logger：为所有组件提供集中式日志记录
• Store：管理提供方和工作区的配置
• MCP Servers：提供 MCP 服务的本地（stdio）和远程（SSE）服务

🪪 安全审计