@servicestack/mcp
2025.03.10
0
JavaScriptAPI 探索笔记系统开发效率
ServiceStack MCP Server 是一个基于 TypeScript 的 MCP 服务器，主要用于探索和调用 ServiceStack API。它实现了一个简单的笔记系统，展示了核心 MCP 概念，包括资源管理、工具创建和提示生成等功能。
View on GitHub
Overview
基本能力
产品定位
ServiceStack MCP Server 是一个用于探索和调用 ServiceStack API 的工具，同时实现了一个简单的笔记系统，用于演示 MCP 核心概念。
核心功能
- 资源管理：
- 通过
note://URI 列出和访问笔记 - 每个笔记包含标题、内容和元数据
-
使用纯文本 MIME 类型简化内容访问
-
工具：
-
create_note：创建新的文本笔记- 需要标题和内容作为必填参数
- 将笔记存储在服务器状态中
-
提示：
summarize_notes：生成所有存储笔记的摘要- 包含所有笔记内容作为嵌入式资源
- 返回结构化提示用于 LLM 摘要生成
适用场景
- 开发人员需要探索和调用 ServiceStack API
- 需要演示或学习 MCP 核心概念
- 需要简单的笔记系统进行资源管理
工具列表
create_note：创建新的文本笔记summarize_notes：生成所有存储笔记的摘要
常见问题解答
- 调试困难：由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。推荐使用 MCP Inspector 进行调试。
使用教程
使用依赖
安装依赖：
npm install
安装教程
构建服务器：
npm run build
开发时自动重建：
npm run watch
与 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 Inspector 进行调试：
npm run inspector
Inspector 将提供一个 URL，用于在浏览器中访问调试工具。