MCP Server Sample

🚀 MCP 服务器示例

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

🚀 快速开始

1. 仓库克隆:

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

2. 依赖项安装:

go mod tidy

3. 服务器运行:

go run main.go

✨ 主要特性

• 处理通过标准输入输出的 JSON 消息
• 符合 MCP 协议的基本数据类型定义
• 具备错误处理功能

📦 安装指南

1. 克隆项目仓库：

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

2. 安装项目依赖：

go mod tidy

3. 启动服务器：

go run main.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)

// 以下定义了 MCP 协议中的消息类型
// `Request`: 表示客户端发送的请求
// `Response`: 表示服务器返回的响应
// `Error`: 表示错误信息
// 这些消息类型是 MCP 协议通信的基础

📚 详细文档

项目结构

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

扩展功能

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

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

📄 许可证

此项目以 MIT 许可证发布。