go-mcp-server-service

go-mcp-server-service

镜像

简介

这是一个符合 JSON-RPC 2.0 标准的服务器,实现了用于笔记管理的模型上下文协议(MCP)。可作为自定义项目的模板,支持跨平台开发。

安装要求

  • Go 1.21+
  • GNU Make
  • Git

快速开始

构建项目

# 开发构建
make dev                # 构建所有平台组件
make dev-windows        # 仅构建 Windows 版本
make dev-linux          # 仅构建 Linux 版本
make dev-darwin         # 仅构建 macOS 版本

# 发布构建
make release-all        # 构建所有平台发布版本

运行

make run-cmd            # 运行命令行接口
make run-service        # 运行服务

Claude 桌面集成

在 Claude Desktop 配置文件中添加:

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

配置文件位置:

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

功能概览

可用工具

  • add-note: 添加新笔记
    • 参数: name (字符串), content (字符串)

可用提示

  • summarize-notes: 创建笔记摘要
    • 可选参数: style ("brief"/"detailed")

调试

使用 MCP Inspector 进行调试:

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

项目结构

.
├── cmd/                    # 命令行接口
├── service/                # 服务实现
├── internal/server/        # 核心服务器实现
├── Makefile                # 构建配置
└── README.md

构建输出

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

许可证

MIT 许可证 © 2024 Andrew Lee Donelson