MCP State Server

🚀 狀態服務器 MCP 服務器

狀態服務器 MCP 服務器是一個基於 TypeScript 的 MCP 服務器，它實現了一個簡單的筆記系統。該系統通過特定方式演示了核心的 MCP 概念，能夠讓用戶通過 note:// URI 列出和訪問筆記資源，還具備創建新筆記以及生成筆記摘要等實用功能。

🚀 快速開始

狀態服務器 MCP 服務器是一個基於 TypeScript 的 MCP 服務器，它實現了一個簡單的筆記系統。該系統通過特定方式演示了核心的 MCP 概念，能夠讓用戶通過 note:// URI 列出和訪問筆記資源，還具備創建新筆記以及生成筆記摘要等實用功能。

✨ 主要特性

資源

• 可通過 note:// URI 列舉和訪問筆記，方便快捷。
• 每個筆記都包含標題、內容和元數據，信息豐富。
• 使用簡單的純文本 MIME 類型進行內容訪問，操作簡便。

工具

• create_note：用於創建新的文本筆記。標題和內容為必填參數，創建的筆記將存儲在服務器狀態中。

提示

• summarize_notes：生成所有存儲筆記的摘要。該功能會包括所有筆記內容作為嵌入資源，並返回結構化的提示以供 LLM 進行總結。

📦 安裝指南

開發環境安裝

安裝依賴：

npm install

構建服務器：

npm run build

帶有自動重建功能的開發：

npm run watch

與 Claude 桌面一起使用的安裝

要與 Claude 桌面一起使用，請添加服務器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "state-server": {
      "command": "/path/to/state-server/build/index.js"
    }
  }
}

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 將提供訪問瀏覽器中的調試工具的 URL。