Notion (via Dify)

🚀 Notion知識庫MCP服務器

這是一個可提供訪問Notion知識庫的MCP服務器，藉助Cline VSCode擴展來實現。它能讓你直接在Cline中查詢Notion知識庫，獲取詳細答案並附帶頁面引用，為知識獲取帶來極大便利。

✨ 主要特性

• 可直接從Cline查詢你的Notion知識庫。
• 獲取詳細答案時還會附帶Notion頁面引用，方便追溯信息來源。
• 採用FastMCP構建，性能可靠穩定。
• 具備全面的錯誤處理和日誌記錄功能，便於排查問題。

📦 安裝指南

先決條件

• Python 3.10或更高版本。
• uv包管理器。
• Cline VSCode擴展。
• 用於訪問Notion知識庫的Dify API密鑰。

安裝步驟

1. 克隆此倉庫：

   git clone https://github.com/yourusername/notion-mcp-server.git
   cd notion-mcp-server
   

2. 創建.env文件並添加你的Dify API密鑰：

   echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env
   

3. 在Cline中安裝服務器：

   fastmcp install notion_mcp_server.py
   

   這一步將自動完成以下操作：

   • 使用uv安裝所有必需依賴項。
   • 配置Cline中的服務器設置。
   • 使服務器可供Cline使用。

💻 使用示例

基礎用法

安裝完成後，你可以在Cline中通過提問來查詢Notion知識庫。例如：

告訴我內部工具的相關信息

服務器將從你的Notion知識庫返回相關信息，包括：

• 詳細答案。
• 相關頁面鏈接。
• 頁面ID供參考。

📚 詳細文檔

配置

服務器在安裝過程中自動配置，但如果你需要手動更新Cline的設置文件，可以這樣做：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

示例配置：

{
  "mcpServers": {
    "notion-kb": {
      "command": "uv",
      "args": [
        "run",
        "--with", "fastmcp",
        "--with", "python-dotenv",
        "--with", "requests",
        "fastmcp",
        "run",
        "/absolute/path/to/notion_mcp_server.py"
      ],
      "env": {
        "DIFY_API_BACKEND_KEY": "your-api-key"
      }
    }
  }
}

開發

用於開發和測試：

1. 安裝依賴項：

   pip install -r requirements.txt
   

2. 運行開發服務器：

   fastmcp dev notion_mcp_server.py
   

這將啟動MCP Inspector界面以測試服務器。

故障排除

1. 服務器無法連接
   • 驗證.env文件中的API密鑰。
   • 確保Cline配置中的服務器路徑為絕對路徑。
   • 檢查uv是否安裝並添加到PATH中。
2. 依賴項問題
   • 嘗試重新安裝：fastmcp install notion_mcp_server.py --force。
   • 驗證uv是否正確安裝。
3. 服務器卡頓
   • 確保使用指定的uv運行命令。
   • 檢查服務器日誌中的錯誤。

貢獻

有關詳細信息，請參閱mcp_instructions.md以獲取服務器實現和架構的詳細說明。

📄 許可證

本項目採用MIT許可證。