go-mcp-server-service

go-mcp-server-service

site icon
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。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。