MCP 计算器

一个用 Go 语言实现的模型上下文协议（MCP）服务器，具有计算器和问候功能。此实现遵循官方 MCP 规范。

功能

• 完整的 JSON-RPC 2.0 实现
• MCP 协议支持
• 工具注册和执行
• 资源处理
• 服务器功能协商
• 根据规范进行错误处理

项目结构

mcpcalculator/
├── mcp/
│   └── protocol/
│       ├── types.go    # 协议类型和结构
│       ├── server.go   # MCP 服务器实现
│       └── client.go   # MCP 客户端实现
├── main.go            # 示例用法
├── go.mod             # Go 模块文件
└── README.md          # 文档

需求

• Go 1.21 或更高版本

安装

git clone https://github.com/akhidasTech/mcpcalculator.git
cd mcpcalculator
go mod download

使用方法

启动服务器

go run main.go

服务器将在 8080 端口启动。

发送请求

工具和资源遵循 JSON-RPC 2.0 规范：

添加工具

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "add",
    "params": {"a": 5, "b": 3}
  }'

问候资源

curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "greeting",
    "params": {"name": "John"}
  }'

响应格式

所有响应都遵循 JSON-RPC 2.0 格式：

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": <结果值>
}

或错误：

{
    "jsonrpc": "2.0",
    "id": 1,
    "error": {
        "code": <错误代码>,
        "message": "错误信息",
        "data": <额外数据>
    }
}

协议实现

此实现遵循模型上下文协议规范：

1. JSON-RPC 2.0：所有通信都使用 JSON-RPC 2.0 协议
2. 功能：服务器在初始化时宣布其能力
3. 工具：实现了工具注册和执行协议
4. 资源：实现了资源访问协议
5. 错误处理：使用标准错误代码和格式

安全性

此实现遵循 MCP 安全指南：

1. 用户同意：工具和资源需要明确调用
2. 数据隐私：没有未经明确请求的数据共享
3. 工具安全：工具执行受到控制和验证
4. 错误处理：正确的错误报告和处理

贡献

欢迎贡献！请随意提交 Pull Request。