MCP服务器项目简介
本项目 'mcp' 是一个实现了 Model Context Protocol (MCP) 协议的服务器端,使用 Go 语言开发。它主要用于将各种工具 (Tools) 以标准化的方式暴露给支持 MCP 协议的大语言模型 (LLM) 客户端,例如 Claude。通过该服务器,LLM 可以在需要时安全地调用外部功能,扩展自身的能力。
主要功能点:
- 工具 (Tools) 注册与管理: 允许开发者注册和管理各种工具,例如计算 SHA-256 哈希值的工具。
- 工具 (Tools) 暴露: 通过 MCP 协议将注册的工具暴露给 LLM 客户端。
- 工具 (Tools) 调用: 接收来自 LLM 客户端的工具调用请求,并执行相应的工具。
- JSON-RPC 通信: 使用标准的 JSON-RPC 协议与 LLM 客户端进行通信。
- 速率限制: 支持对工具调用进行速率限制,防止滥用。
- 标准输入/输出 (Stdio) 传输: 默认使用标准输入/输出流作为通信协议,易于集成。
安装步骤:
- 安装 Go 语言环境: 确保你的电脑上已经安装了 Go 语言的开发环境。你可以从 https://go.dev/dl/ 下载并安装。
- 克隆仓库: 使用 Git 克隆 'mcp' 仓库到本地:
git clone https://github.com/acrmp/mcp cd mcp - 编译服务器: 进入 'example' 目录,编译示例服务器程序:
cd example GOOS=[你的操作系统] GOARCH=[你的架构] go build- 将 '[你的操作系统]' 替换为你的操作系统名称,例如 'darwin' (macOS), 'linux' (Linux), 'windows' (Windows)。
- 将 '[你的架构]' 替换为你的系统架构,例如 'arm64' (Apple Silicon, ARM Linux), 'amd64' (Intel/AMD 64-bit)。
- 例如,在 macOS (Apple Silicon) 上,命令为 'GOOS=darwin GOARCH=arm64 go build'。
- 编译成功后,会在 'example' 目录下生成一个名为 'example' (或 'example.exe' 在 Windows 上) 的可执行文件。
服务器配置 (给 MCP 客户端配置):
MCP 服务器是为 MCP 客户端(如 Claude)设计的后端服务,客户端需要配置服务器的启动命令才能连接。以下是配置示例,你需要根据你的实际情况进行调整。
假设你已经按照上面的安装步骤,在 '~/mcp/example' 目录下编译生成了 'example' 可执行文件。
对于 Claude 客户端,你需要修改 Claude 的配置文件 'claude_desktop_config.json'。该文件通常位于:
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
- Linux: '~/.config/Claude/claude_desktop_config.json'
打开 'claude_desktop_config.json' 文件,在 'mcpServers' 字段下添加你的 MCP 服务器配置。例如,配置一个名为 'sha256' 的服务器:
{ "mcpServers": { "sha256": { "command": "/path/to/mcp/example/example" } } }
- '"sha256"': 是你为这个 MCP 服务器配置起的名字,可以自定义,在 Claude 中用于引用该服务器。
- '"command"': 必须修改为你的 'example' 可执行文件的绝对路径。 例如,如果你的 'mcp' 仓库克隆在 '~/Documents/mcp',并且在 macOS 上,则路径可能为 '"/Users/[你的用户名]/Documents/mcp/example/example"'。请根据你的实际路径修改。
基本使用方法 (与 Claude 客户端交互):
-
启动 MCP 服务器: 无需手动启动,Claude 客户端会在需要时自动启动配置的 MCP 服务器。
-
在 Claude 中使用工具: 在 Claude 的对话框中,你可以使用自然语言指示 Claude 使用配置的工具。例如,在配置了 'sha256' 服务器后,你可以问 Claude:
What is the sha256sum of "hello world"?
-
Claude 调用工具并返回结果: Claude 客户端会识别到你需要使用 'sha256' 服务器提供的 'sha256sum' 工具,并自动调用该工具,然后将计算出的 SHA-256 哈希值返回给你。
注意:
- 本示例只包含一个简单的 SHA-256 哈希计算工具。你可以根据 'example/main.go' 的代码结构,添加更多自定义的工具。
- 确保 'claude_desktop_config.json' 文件配置正确,特别是 '"command"' 字段的路径要指向你编译生成的可执行文件。
- MCP 客户端 (如 Claude) 的具体配置方法可能会有所不同,请参考你使用的 MCP 客户端的官方文档。
信息
分类
AI与计算