🚀 MCP 服务器示例

本项目是一个符合 Model Context Protocol (MCP) 标准的服务器基础实现。MCP 协议用于在模型和本地运行的 MCP 服务器之间搭建通信桥梁，为模型交互提供了稳定可靠的通信机制。

🚀 快速开始

克隆仓库

git clone <repository-url>
cd mcp-server-sample

安装依赖

go mod tidy

运行服务器

go run main.go

✨ 主要特性

• 能够处理通过标准输入输出的 JSON 消息，确保数据的高效传输和解析。
• 严格遵循 MCP 协议的基本数据类型定义，保证数据的准确性和一致性。
• 具备完善的错误处理功能，增强系统的稳定性和可靠性。

📦 安装指南

1. 克隆仓库：将项目仓库克隆到本地。

git clone <repository-url>
cd mcp-server-sample

2. 安装依赖：使用 go mod tidy 命令安装项目所需的依赖。

go mod tidy

3. 运行服务器：通过 go run main.go 命令启动服务器。

go run main.go

💻 使用示例

基础用法

以下是 ServerInfo 结构体的定义，用于管理服务器的基本信息。

type ServerInfo struct {
    Name    string `json:"name"`
    Version string `json:"version"`
}

高级用法

以下是 Server 结构体的定义，提供了 MCP 服务器的基本功能。

type Server struct {
    info         ServerInfo
    capabilities map[string]interface{}
}

📚 详细文档

项目结构

.
├── main.go              # 主服务器实现文件
├── go.mod              # Go 模块定义文件
└── server/
    └── types.go        # MCP 协议的类型定义

主要组件

ServerInfo (main.go)

管理服务器基本信息的结构体。

type ServerInfo struct {
    Name    string `json:"name"`
    Version string `json:"version"`
}

Server (main.go)

提供 MCP 服务器基本功能的结构体。

type Server struct {
    info         ServerInfo
    capabilities map[string]interface{}
}

MCP 消息类型 (server/types.go)

• Request: 表示客户端发送的请求
• Response: 表示服务器返回的响应
• Error: 表示错误信息

扩展功能

此服务器可通过以下功能进行扩展：

1. 工具的实现
   • 添加特定功能的工具
   • 定义工具的参数和响应
2. 资源的实现
   • 添加静态/动态资源
   • 定义资源模板
3. 消息处理程序
   • 实现特定方法的处理程序
   • 自定义错误处理

📄 许可证

此项目以 MIT 许可证发布。