🚀 MCP 计算器

MCP 计算器是一个用 Go 语言实现的模型上下文协议（MCP）服务器，具备计算器和问候功能，且严格遵循官方 MCP 规范。该项目为相关开发和应用提供了可靠的基础。

✨ 主要特性

• 完整实现 JSON-RPC 2.0 协议，保障通信的标准化和规范性。
• 全面支持 MCP 协议，确保与其他遵循该协议的系统无缝对接。
• 支持工具注册和执行，方便用户灵活使用各种功能。
• 具备资源处理能力，有效管理和操作相关资源。
• 可进行服务器功能协商，根据实际需求调整服务能力。
• 依据规范进行错误处理，提高系统的稳定性和可维护性。

📦 安装指南

环境要求

• 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": <额外数据>
    }
}

📚 详细文档

项目结构

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

协议实现

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

1. JSON-RPC 2.0：所有通信都使用 JSON-RPC 2.0 协议，确保数据交互的标准化。
2. 功能：服务器在初始化时宣布其能力，方便客户端了解和使用。
3. 工具：实现了工具注册和执行协议，支持用户灵活调用各种工具。
4. 资源：实现了资源访问协议，有效管理和操作相关资源。
5. 错误处理：使用标准错误代码和格式，提高系统的可维护性。

安全性

此实现遵循 MCP 安全指南：

1. 用户同意：工具和资源需要明确调用，保障用户的自主选择权。
2. 数据隐私：没有未经明确请求的数据共享，保护用户数据安全。
3. 工具安全：工具执行受到控制和验证，防止恶意操作。
4. 错误处理：正确的错误报告和处理，及时发现和解决问题。

🤝 贡献

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