go-mcp-server-service

go-mcp-server-service

一个实现用于笔记管理(作为示例)的模型上下文协议 (MCP) 的 JSON-RPC 2.0 兼容服务器。

概述

这是一个符合JSON-RPC 2.0标准的服务器,实现了用于笔记管理的模型上下文协议(MCP)。它支持跨平台开发,包含命令行界面和服务组件。

开始使用

先决条件

  • Go 1.21+
  • GNU Make
  • Git

构建项目

# 开发构建
make dev

# 发布构建
make release-all

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

运行项目

# 运行命令行界面
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

功能亮点

  • 资源管理:使用note://URI方案访问笔记
  • 提示summarize-notes创建所有笔记的摘要
  • 工具add-note添加新笔记

调试

使用MCP Inspector进行调试:

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

项目结构

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

许可证

MIT许可证,版权所有 (c) 2024 Andrew Lee Donelson