Mcpcalculator

🚀 MCP 计算器

MCP 计算器是一个用 Go 语言实现的模型上下文协议（MCP）服务器，具备计算器和问候功能，且严格遵循官方 MCP 规范。它能有效解决在特定场景下对 MCP 协议应用的需求，为用户提供便捷的工具注册、执行以及资源处理等服务。

🚀 快速开始

MCP 计算器的使用十分便捷，只需按照以下步骤操作即可。

安装

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

✨ 主要特性

• 完整的 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 端口启动。

高级用法

发送请求时，可根据具体需求修改请求参数，例如在添加工具请求中修改 params 里的 a 和 b 的值，或者在问候资源请求中修改 params 里的 name 的值。

📚 详细文档

项目结构

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. 错误处理：正确的错误报告和处理。

🔧 技术细节

本项目使用 Go 语言实现，严格遵循官方 MCP 规范和 JSON-RPC 2.0 协议。在项目结构上，将不同功能模块进行了合理划分，如 mcp/protocol 目录下包含了协议类型和结构、服务器实现以及客户端实现等文件。在协议实现方面，确保了通信的标准化和兼容性，支持工具注册、执行以及资源处理等功能。同时，在安全性上遵循 MCP 安全指南，保障了用户数据的隐私和工具执行的安全。

📄 许可证

文档中未提及相关许可证信息。

贡献

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