🚀 快速构建高性能Go MCP服务器
简体中文介绍
这个项目是 MCP服务器示例 使用 努努 框架和 MCP-GO。它允许您快速设置基于Golang的MCP服务器,并使用MCP检查器工具对其进行测试/调试。
🚀 快速入门:在3分钟内运行MCP服务器
1.创建项目
Option 1: Clone the Template Repository```bash
git clone https://github.com/go-nunu/nunu-layout-mcp.git
Note: The default project name is nunu-layout-mcp
Option 2: Create a New Project via Nunu CLI (Recommended)```bash
go install github.com/go-nunu/nunu@latest
nunu new mcp-demo -r https://github.com/go-nunu/nunu-layout-mcp.git
2.构建和启动
构建MCP服务器```bash
cd mcp-demo
go build -ldflags="-s -w" -o ./bin/server ./cmd/server
#### 启动MCP检查器
MCP Inspector是MCP社区提供的用于测试和调试的交互式开发工具:```bash
npx -y @modelcontextprotocol/inspector ./bin/server
# Requires Node.js to be installed
3.测试服务
打开浏览器: http://127.0.0.1:6274 以测试不同的传输协议。
| 传输类型 | 地址/参数 | 用例 | 优点 | 缺点 |
|---|---|---|---|---|
| STDIO | ./bin/server |
CLI工具、桌面应用程序 | 简单、安全、无需网络 | 仅限本地、单客户端 |
| SSE | http://localhost:3001/sse |
Web实时通信 | 多客户端、实时、浏览器友好 | HTTP开销,仅服务器到客户端 |
| 流式HTTP | http://localhost:3002/mcp |
Web服务、API | 标准协议、缓存和负载平衡 | 没有实时支持,稍显复杂 |
| 进程中 | (无外部地址) | 嵌入式,测试 | 无序列化,超快 | 仅进程中 |
🛠️ 开发指南
由于该项目是建立在 努努建筑,建议在开发之前了解框架。
📡 MCP服务器开发
请参阅 MCP-GO服务器文档
此项目默认启用三种协议:STDIO、SSE、StreamableHTTP。您可以根据需要修改或禁用它们:```go
// File: internal/server/mcp.go
func setupSrv(logger log.Logger) servermcp.Server {
mcpServer := server.NewMCPServer(
"example-servers/everything",
"1.0.0",
server.WithResourceCapabilities(true, true),
server.WithPromptCapabilities(true),
server.WithToolCapabilities(true),
server.WithLogging(),
server.WithHooks(newHooks(logger)),
)
return servermcp.NewServer(logger,
servermcp.WithMCPSrv(mcpServer),
// STDIO
servermcp.WithStdioSrv(true),
// SSE
servermcp.WithSSESrv(":3001", server.NewSSEServer(
mcpServer,
server.WithSSEEndpoint("/sse"),
)),
// StreamableHTTP
servermcp.WithStreamableHTTPSrv(":3002", server.NewStreamableHTTPServer(
mcpServer,
server.WithEndpointPath("/mcp"),
)),
)
}
#### 呼叫流程图```txt
client
↓
internal/server/mcp.go
↓
internal/handler/example.go
↓
internal/service/example.go
↓
internal/repository/example.go
↓
DB / Third-party services
注:
如果 MCP STDIO 被启用, 不应将日志打印到终端,否则通信将中断。您必须将日志配置为仅写入文件:```yaml
File: config/local.yml
log:
log_level: debug
mode: file # file, console, or both
encoding: console # json or console
log_file_name: "./storage/logs/server.log"
max_backups: 30
max_age: 7
max_size: 1024
compress: true
在Unix系统中查看日志:```bash
tail -f storage/logs/server.log
🤝 集成MCP客户端
看 MCP-GO客户文件
您可以在以下网址注册客户 internal/repository/repository.go例如:go
func NewStdioMCPClient() *client.Client {
c, err := client.NewStdioMCPClient(
"go", []string{}, "run", "/path/to/server/main.go",
)
if err != nil {
panic(err)
}
defer c.Close()
return c
}
要集成其他协议或客户端,请遵循中使用的类似模式 redis, gorm等等。
📚 资源
- 努努建筑
- MCP协议概述
- MCP检查员指南
- MCP-GO文件
最后说明
目前,有 没有官方的Golang SDK 由MCP组织提供。最成熟的开源项目是 mark3labs/mcp-go.
我们期待着官方的Golang SDK,一旦发布,该项目将相应更新。
官方Go MCP SDK: https://github.com/golang/tools/tree/master/internal/mcp
📄 许可证
努努被释放 MIT许可证 --免费使用和贡献!
