mcp notion

概念MCP服務器： notion-texonom

基於Markdown的概念僅使用一個ROOT_PAGE變量導航MCP，從而消除了對令牌的需求。

• 概念頁面被​​轉換為text/markdown mimeType註釋。
• 考慮親子和參考關係，搜索和檢索相關頁面。

用於管理和與基於概念的註釋進行管理和交互的模型上下文協議（MCP）服務器。這款基於打字稿的服務器通過集成資源，工具和提示來有效與概念頁面進行交互來演示MCP概念。

特徵

資源

• 訪問說明：列出和檢索概念頁面為note://帶有uuid slugs的uris。
• 元數據：每個資源都包含標題，描述和內容，以降價格式。
• MIME類型：以text/markdown格式訪問內容。

工具

• 搜索說明：使用search_notes工具使用查詢字符串搜索概念頁面。
  • 輸入：查詢文本以過濾相關頁面。
  • 輸出：匹配註釋的降價內容。

提示

• 總結說明：生成單個概念頁面的摘要。
  • 可用提示：
    • summarize_note ：總結URI的具體說明。
    • suggest_refactor ：提出結構改進。
    • suggest_fix ：確定筆記內容的潛在修復程序。
    • suggest_enhance ：建議增強功能以​​改善註釋。
  • 輸入：概念頁URI。
  • 輸出：用於匯總和增強的結構化消息。

發展

設定

安裝依賴項：

pnpm install

建立項目：

pnpm build

用於自動建造的開發：

pnpm watch

配置

用概念配置服務器：

• 設置環境變量：
  • ROOT_PAGE ：概念工作區的根頁ID。

Claude Desktop的安裝

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

• macos： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%/Claude/claude_desktop_config.json

示例配置：

{
  "mcpServers" : {
    "notion-texonom" : {
      "command" : " node " ,
      "args" : [
        " /path/to/mcp/build/index.js "
      ],
      "env" : {
        "ROOT_PAGE" : " $SOME_UUID "
      }
    }
  }
}

偵錯

要進行故障排除和調試MCP服務器，請使用MCP Inspector。要啟動檢查員，請運行：

pnpm inspector

檢查員提供了一個基於瀏覽器的接口，用於檢查基於STDIO的服務器通信。

關鍵技術

• 概念集成：由@texonom/nclient和@texonom/cli.
• MCP SDK：用於服務器操作的@modelcontextprotocol/sdk 。