项目简介

'mcp' 工具是一个命令行和本地UI工具,用于发现、安装和管理 Model Context Protocol (MCP) 服务器。它本身不提供任何功能,而是充当客户端和多个已安装的 MCP 服务器之间的代理。

主要功能点

  • MCP 服务器代理: 作为 MCP 客户端的服务器代理,转发和管理客户端请求。
  • MCP 服务器发现与安装: 帮助用户从公共注册中心发现和安装 MCP 服务器。
  • OAuth2 凭证管理: 管理 MCP 服务器的 OAuth2 凭证获取、存储和刷新流程。
  • 操作审计日志: 记录所有操作日志,并提供 UI 查看审计记录。
  • Docker 容器化: 使用 Docker 运行 MCP 服务器,隔离主机系统依赖,提高安全性。

安装步骤

  1. 确保已安装 Go 语言环境。
  2. 克隆 GitHub 仓库到本地:
    git clone https://github.com/ggoodman/mcp
    cd mcp
  3. 编译 'mcp' 命令行工具:
    go build -o mcp cmd/mcp/main.go

服务器配置

MCP 客户端需要配置连接到 'mcp' 服务器代理的启动命令和参数。以下是配置信息示例(JSON 格式):

{
  "serverName": "mcp-broker",
  "command": "./mcp",
  "args": ["run", "stdio"]
}

参数注释:

  • 'command': 'mcp' 工具的可执行文件路径,例如 './mcp'。
  • 'args': 启动参数,'["run", "stdio"]' 表示启动 'mcp' 工具作为 stdio MCP 服务器代理,用于与 MCP 客户端通过标准输入输出流进行通信。

基本使用方法

  1. 启动 MCP 服务器代理: 在终端中,导航到 'mcp' 工具所在目录,并运行以下命令启动服务器代理:
    ./mcp serve stdio
    或者
    ./mcp run stdio
  2. 配置 MCP 客户端: 在 MCP 客户端中,配置连接到 'mcp' 服务器代理,使用上述服务器配置信息。客户端将通过标准输入输出流与 'mcp' 服务器代理建立连接。
  3. 安装 MCP 服务器包: 使用 'mcp package install <package_name>' 命令安装需要的 MCP 服务器包。例如,安装 GitHub MCP 服务器:
    ./mcp package install @modelcontextprotocol/server-github
  4. 搜索 MCP 服务器包: 使用 'mcp registry search <query>' 命令在注册中心搜索 MCP 服务器包。例如,搜索 "github" 相关的服务器:
    ./mcp registry search github
  5. 客户端与 MCP 服务器交互: MCP 客户端的所有 MCP 请求将通过 'mcp' 服务器代理转发到已安装的 MCP 服务器,实现上下文服务。

注意: 'mcp' 工具本身作为一个代理,需要配合其他 MCP 服务器包才能提供实际的资源和工具功能。

信息

分类

开发者工具