
go-mcp-server-service

2024.12.27
0
Go笔记管理JSON-RPC 2.0MCP 协议其它
go-mcp-server-service 是一个符合 JSON-RPC 2.0 标准的服务器,实现了模型上下文协议(MCP),主要用于笔记管理。该项目支持跨平台开发,包括命令行界面和服务组件,适用于开发和发布构建。
View on GitHub
Overview
基本能力
产品定位
go-mcp-server-service 是一个基于 JSON-RPC 2.0 和 MCP 协议的笔记管理服务器,提供跨平台的开发和发布构建支持。
核心功能
- JSON-RPC 2.0 兼容的 API
- 跨平台支持(Windows、Linux、macOS)
- 线程安全的笔记管理
- 开发和发布构建配置
- 服务组件和命令行界面
适用场景
- 笔记管理系统的开发
- 跨平台应用程序的后端服务
- 需要线程安全并发访问的资源管理
工具列表
add-note
: 添加新笔记到服务器- 必需参数:
name
(字符串),content
(字符串) - 线程安全的状态更新
- 返回确认消息
常见问题解答
- 错误代码:
- -32700: 解析错误
- -32600: 无效请求
- -32601: 方法未找到
- -32602: 无效参数
- -32603: 内部错误
- -32001: 资源未找到
- -32002: 不支持的操作
使用教程
使用依赖
- 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
调试方式
使用 MCP Inspector 进行调试:
npx @modelcontextprotocol/inspector ./bin/dev/<platform>/notes-server
Inspector 将提供一个调试界面的 URL。