基于Go的MCP服务器服务

这是一个符合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（用于版本信息）

构建命令

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

# 构建所有组件的所有平台
make dev

# 为特定平台构建
make dev-windows
make dev-linux
make dev-darwin

# 构建特定组件
make build-cmd
make build-service

发布构建（优化并去除符号）：

# 构建所有组件的所有平台
make release-all

# 为特定平台构建
make release-windows
make release-linux
make release-darwin

本地运行：

# 运行命令行界面
make run-cmd

# 运行服务
make run-service

查看所有目标：

make help

构建输出

可执行文件存放在bin目录中：

• 开发构建：bin/
• 发布构建：dist/

配置

在以下位置查找配置文件：

$XDG_CONFIG_HOME/mcnotes.json

默认情况下，这相当于：

~/.config/mcnotes.json

项目结构图

.
├── cmd/
│   ├── add-note/           # 添加笔记的工具
│   └── summarize-notes/    # 汇总笔记的提示
├── service/                # 服务组件
└── resources/              # 资源管理

错误代码

以下是可能的错误代码：

项目结构图

.
├── README.md               # 项目说明文档
├── go.mod                 # Go模块文件
├── go.sum                 # Go依赖项检查和认证文件
├── cmd/
│   ├── add-note/
│   │   └── main.go       # 添加笔记的主程序
├── service/
│   └── server.go         # 服务端实现
└── resources/
    └── note_manager.go   # 笔记管理器

配置示例

{
  "debug": false,
  "port": 8080,
  "database": {
    "driver": "sqlite3",
    "path": "notes.db"
  }
}

许可证

此项目在MIT License下开源。

如有其他问题，请参考官方文档。