🚀 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 # 文档
协议实现
此实现遵循模型上下文协议规范：
- JSON-RPC 2.0：所有通信都使用 JSON-RPC 2.0 协议。
- 功能：服务器在初始化时宣布其能力。
- 工具：实现了工具注册和执行协议。
- 资源：实现了资源访问协议。
- 错误处理：使用标准错误代码和格式。
安全性
此实现遵循 MCP 安全指南：
- 用户同意：工具和资源需要明确调用。
- 数据隐私：没有未经明确请求的数据共享。
- 工具安全：工具执行受到控制和验证。
- 错误处理：正确的错误报告和处理。
🔧 技术细节
本项目使用 Go 语言实现，严格遵循官方 MCP 规范和 JSON-RPC 2.0 协议。在项目结构上，将不同功能模块进行了合理划分，如 mcp/protocol 目录下包含了协议类型和结构、服务器实现以及客户端实现等文件。在协议实现方面，确保了通信的标准化和兼容性，支持工具注册、执行以及资源处理等功能。同时，在安全性上遵循 MCP 安全指南，保障了用户数据的隐私和工具执行的安全。
📄 许可证
文档中未提及相关许可证信息。
贡献
欢迎贡献！请随意提交 Pull Request。