项目简介
'mcp' 工具是一个命令行和本地UI工具,用于发现、安装和管理 Model Context Protocol (MCP) 服务器。它本身不提供任何功能,而是充当客户端和多个已安装的 MCP 服务器之间的代理。
主要功能点
- MCP 服务器代理: 作为 MCP 客户端的服务器代理,转发和管理客户端请求。
- MCP 服务器发现与安装: 帮助用户从公共注册中心发现和安装 MCP 服务器。
- OAuth2 凭证管理: 管理 MCP 服务器的 OAuth2 凭证获取、存储和刷新流程。
- 操作审计日志: 记录所有操作日志,并提供 UI 查看审计记录。
- Docker 容器化: 使用 Docker 运行 MCP 服务器,隔离主机系统依赖,提高安全性。
安装步骤
- 确保已安装 Go 语言环境。
- 克隆 GitHub 仓库到本地:
git clone https://github.com/ggoodman/mcp cd mcp - 编译 '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 客户端通过标准输入输出流进行通信。
基本使用方法
- 启动 MCP 服务器代理: 在终端中,导航到 'mcp' 工具所在目录,并运行以下命令启动服务器代理:
或者./mcp serve stdio./mcp run stdio - 配置 MCP 客户端: 在 MCP 客户端中,配置连接到 'mcp' 服务器代理,使用上述服务器配置信息。客户端将通过标准输入输出流与 'mcp' 服务器代理建立连接。
- 安装 MCP 服务器包: 使用 'mcp package install <package_name>' 命令安装需要的 MCP 服务器包。例如,安装 GitHub MCP 服务器:
./mcp package install @modelcontextprotocol/server-github - 搜索 MCP 服务器包: 使用 'mcp registry search <query>' 命令在注册中心搜索 MCP 服务器包。例如,搜索 "github" 相关的服务器:
./mcp registry search github - 客户端与 MCP 服务器交互: MCP 客户端的所有 MCP 请求将通过 'mcp' 服务器代理转发到已安装的 MCP 服务器,实现上下文服务。
注意: 'mcp' 工具本身作为一个代理,需要配合其他 MCP 服务器包才能提供实际的资源和工具功能。
信息
分类
开发者工具