go-mcp-server-service

go-mcp-server-service

一个符合 JSON-RPC 2.0 标准的服务器示例，用于实现模型上下文协议（MCP）并管理笔记

这是一个示例。你可以修改它，并将其用作自己项目的模板。它支持跨平台开发，并包含命令行界面和服务组件，可用于开发版和发布版构建。

功能

• 符合 JSON-RPC 2.0 标准的 API
• 跨平台支持（Windows、Linux、macOS）
• 线程安全的笔记管理
• 开发版和发布版构建配置
• 服务和命令行界面组件

组件

命令行界面（cmd）

命令行界面可直接访问笔记服务的功能。

服务（service）

服务组件支持系统级集成和后台运行。

资源

服务器实现了一个笔记存储系统，具有以下特性：

• 用于访问单条笔记的自定义 note:// URI 方案
• 包含名称、描述和 MIME 类型的资源元数据
• 线程安全的并发访问

提示词

可用的提示词：

• summarize-notes：汇总所有已存储的笔记
  • 可选的 style 参数（“brief”/“detailed”）
  • 根据风格偏好汇总所有当前笔记
  • 线程安全的笔记访问

工具

可用的工具：

• add-note：向服务器添加一条新笔记
  • 必需参数：name（字符串）、content（字符串）
  • 线程安全的状态更新
  • 返回确认消息

构建

先决条件

• Go 1.21 或更高版本
• GNU Make 或兼容的构建工具
• Git（用于版本信息）

构建命令

开发版构建（包含调试符号和竞态检测）：

# Build all components for all platforms
make dev

# Build for specific platform
make dev-windows
make dev-linux
make dev-darwin

# Build specific components
make build-cmd
make build-service

发布版构建（已优化并剥离符号）：

# Build all components for all platforms
make release-all

# Build for specific platform
make release-windows
make release-linux
make release-darwin

在本地运行：

# Run command-line interface
make run-cmd

# Run service
make run-service

查看所有可用目标：

make help

构建输出

二进制文件会生成在 bin 目录中：

• 开发版构建：bin/dev/<platform>/
• 发布版构建：bin/release/<platform>/

配置

Claude Desktop 集成

在 Claude Desktop 的配置文件中配置笔记服务器：

位置

• MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

开发配置

{
  "mcpServers": {
    "notes-server": {
      "command": "./bin/dev/<platform>/notes-server",
      "args": []
    }
  }
}

发布配置（服务示例）

{
  "mcpServers": {
    "notes-server": {
      "command": "./bin/release/<platform>/notes-service",
      "args": []
    }
  }
}

开发

项目结构

.
├── cmd/                    # Command-line interface
├── service/               # Service implementation
├── internal/
│   └── server/           # Core server implementation
│       ├── operations.go # Server operations
│       ├── server.go    # Main server logic
│       └── types.go     # Type definitions
├── Makefile              # Build configuration
└── README.md

调试

由于服务器通过 stdio 运行，我们建议使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector ./bin/dev/<platform>/notes-server

Inspector 会提供一个用于调试界面的 URL。

错误代码

服务器实现了标准 JSON-RPC 2.0 错误代码，以及自定义代码：

代码	描述	标准
-32700	解析错误	是
-32600	请求无效	是
-32601	找不到方法	是
-32602	参数无效	是
-32603	内部错误	是
-32001	找不到资源	否
-32002	不支持的操作	否

许可证

MIT 许可证

Copyright (c) 2024 Andrew Lee Donelson