MCP Practice

🚀 我的服務器 MCP 服務器

本項目是一個基於 TypeScript 的 MCP 服務器，實現了簡單的筆記系統。它藉助 note:// URI 和元數據達成文本筆記的訪問與列舉，還配備創建新筆記的工具以及生成筆記摘要的提示功能，充分展示了 MCP 的核心概念。

🚀 快速開始

本 MCP 服務器能讓你輕鬆管理筆記，通過特定的 URI 訪問和操作筆記，還能利用工具創建新筆記並生成摘要。

✨ 主要特性

資源

• 可列出並訪問以 note:// 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": {
    "my-server": {
      "command": "/path/to/my-server/build/index.js"
    }
  }
}

🔧 技術細節

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能會比較困難。我們推薦使用 MCP 檢查器，它可以通過包腳本運行：

npm run inspector

檢查器將在瀏覽器中提供一個訪問調試工具的 URL，幫助你更方便地進行調試工作。