🚀 @servicestack/mcp

ServiceStack MCP 服务端主要用于探索和调用服务栈 API。这是一个基于 TypeScript 构建的 MCP 服务器，实现了一个简单的笔记系统，通过该系统可以很好地演示核心 MCP 概念。

🚀 快速开始

ServiceStack MCP 服务端借助 note:// URI 实现对笔记的访问和列出操作。每个笔记包含标题、内容以及元数据，并且采用纯文本 MIME 类型，方便进行简单的内容访问。

✨ 主要特性

资源

• 支持通过 URI 列出并访问笔记。
• 每个笔记都具备标题、内容和元数据。
• 采用纯文本 MIME 类型，便于简单的内容访问。

工具

• create_note：用于创建新的文本笔记。
  • 该工具要求必须传入标题和内容作为参数。
  • 会将创建的笔记存储在服务器状态中。

提示

• summarize_notes：可生成所有已存储笔记的摘要。
  • 会将所有笔记内容作为嵌入式资源包含在内。
  • 返回结构化的提示信息，可用于 LLM 摘要生成。

📦 安装指南

开发依赖安装

安装项目所需的依赖：

npm install

服务器构建

构建服务器：

npm run build

开发模式

带有自动重建功能的开发模式：

npm run watch

与 Claude Desktop 配合使用时的安装

在与 Claude Desktop 配合使用时，需要添加服务器配置：

• 在 MacOS 系统上，配置文件路径为：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 系统上，配置文件路径为：%APPDATA%/Claude/claude_desktop_config.json

以下是配置示例：

{
  "mcpServers": {
    "@servicestack/mcp": {
      "command": "/path/to/@servicestack/mcp/build/index.js"
    }
  }
}

📚 详细文档

调试说明

由于 MCP 服务器是通过标准输入输出进行通信的，因此调试工作可能具有一定的挑战性。我们推荐使用 MCP Inspector 工具来辅助调试，该工具作为包脚本提供，使用以下命令即可启动：

npm run inspector

启动后，Inspector 会提供一个可以在浏览器中访问的 URL，通过该 URL 可以获取调试工具。