Servicestack MCP

🚀 @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 可以獲取調試工具。