使用说明

项目简介

MyCoder-MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器套件,旨在为大型语言模型 (LLM) 应用提供标准化的上下文信息和功能扩展。它包含多个独立的 MCP 服务器,分别提供文本编辑器、终端 Shell 命令执行、网络数据抓取以及 Agent 管理等能力,帮助 LLM 应用更有效地与外部环境交互。

主要功能点

  • 文本编辑器服务 (Text Editor Server): 允许 LLM 客户端查看、创建和编辑文件,支持文件内容的持久化存储和编辑历史的撤销 (Undo) 功能。
  • 终端 Shell 服务 (Shell Server): 使 LLM 客户端能够执行终端 Shell 命令,并与正在运行的进程进行交互,获取实时的命令输出。
  • 网络数据获取服务 (Fetch Server): 提供 HTTP 请求功能,让 LLM 客户端可以调用外部 API 接口,获取网络数据。
  • Agent 管理服务 (Agent Server): 提供基础的 Agent 管理功能,例如启动、发送消息、查询状态和列出 Agent 实例。

安装步骤

  1. 环境准备: 确保已安装 Node.js (v18 或更高版本) 和 PNPM (v8 或更高版本)。
  2. 克隆仓库:
    git clone https://github.com/bhouston/mycoder-mcp.git
    cd mycoder-mcp
  3. 安装依赖:
    pnpm install
  4. 构建项目:
    pnpm build

服务器配置

MCP 客户端需要配置连接 MCP 服务器的相关信息。MyCoder-MCP 套件包含多个独立的服务器,您可以根据需要选择启动并配置相应的服务器。以下是不同服务器的配置示例,客户端需要根据实际使用的服务器类型进行配置,并替换路径为实际仓库路径。

[
  {
    "server name": "文本编辑器服务器",
    "command": "node",
    "args": ["/path/to/mycoder-mcp/packages/mcp-server-text-editor/bin/cli.js"]
  },
  {
    "server name": "Shell 命令服务器",
    "command": "node",
    "args": ["/path/to/mycoder-mcp/packages/mcp-server-shell/bin/cli.js"]
  },
  {
    "server name": "网络数据获取服务器",
    "command": "node",
    "args": ["/path/to/mycoder-mcp/packages/mcp-server-fetch/dist/index.js"]
  },
  {
    "server name": "Agent 管理服务器",
    "command": "node",
    "args": ["/path/to/mycoder-mcp/packages/mcp-server-agent/dist/index.js"]
  }
]

注意:

  • 请将 '/path/to/mycoder-mcp' 替换为您克隆仓库的实际本地路径。
  • 'command' 通常设置为 'node',表示使用 Node.js 运行时环境。
  • 'args' 数组包含 MCP 服务器的启动脚本路径。

基本使用方法

  1. 启动服务器: 在每个服务器的包目录下 ('packages/mcp-server-text-editor', 'packages/mcp-server-shell' 等),可以使用 'pnpm dev' 命令启动开发模式的服务器,或者直接运行构建后的脚本文件(例如 'packages/mcp-server-text-editor/bin/cli.js' 或 'packages/mcp-server-fetch/dist/index.js')。
  2. 客户端连接: MCP 客户端需要根据配置信息连接到相应的 MCP 服务器。具体的连接和使用方式请参考 MCP 客户端的文档。客户端可以通过 JSON-RPC 协议与服务器交互,调用服务器提供的工具 (Tools) 和资源 (Resources)。

示例: 如果 MCP 客户端需要使用文本编辑器功能,则需要配置并连接到 "文本编辑器服务器",然后调用服务器提供的 'text_editor' 工具来执行文件操作。

信息

分类

开发者工具