MCP Server (Go)

MCP 服务（Go）

一个使用 Go 实现的 Model Context Protocol（MCP）服务，可通过 JSON-RPC 接口提供数据库查询功能。

功能

• JSON-RPC 2.0 协议实现
• 用于实时通信的服务器发送事件（SSE）
• SQLite 数据库集成
• 基于工具的架构，便于扩展功能
• 支持身份验证

可用工具

1. 查询工具

   • 对数据库执行 SQL 查询
   • 以表格形式返回结果

2. 列出表工具

   • 列出数据库中的所有可用表

入门指南

前提条件

• Go 1.x
• SQLite3

安装

1. 克隆仓库：

git clone <repository-url>
cd mcp_server_go

2. 安装依赖项：

go mod download

配置

服务使用简单的基于令牌的身份验证系统。预期令牌在服务配置中硬编码为 "abcd"。

运行服务

go run main.go

服务将在端口 8777 上启动。

API 文档

身份验证

所有请求都必须包含 Authorization 标头，格式如下：

Authorization: Bearer <token>

端点

1. 根端点（/）

• 方法：GET
• 用途：建立服务器发送事件（SSE）连接
• 响应：返回用于消息通信的端点 URL

2. 消息端点（/messages/{sessionID}）

• 方法：POST
• 用途：处理客户端请求
• 支持的方法：
  • initialize：初始化连接
  • tools/list：列出可用工具
  • tools/call：执行指定工具

使用示例

1. 初始化连接：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {}
}

2. 列出可用工具：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

3. 执行查询：

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "query",
    "arguments": {
      "query": "SELECT * FROM your_table"
    }
  }
}

项目结构

mcp_server_go/
├── main.go              # Main server implementation
├── pkg/
│   ├── messages/        # Message structures
│   ├── methods/         # Request handling methods
│   └── tools/           # Tool implementations
└── mcp.db              # SQLite database file