MCP Server Notion

🚀 Notion MCP 服務器

該項目實現了一個用於 Claude AI 和 Notion 工作區之間無縫集成的 Model Context Protocol (MCP) 服務器，支持讀寫功能，讓 Claude AI 能與 Notion 工作區高效交互。

🚀 快速開始

先決條件

• Node.js (v16+)
• Notion API 密鑰
• Claude Desktop

操作步驟

1. 設置 Notion API 訪問權限

1. 在 https://www.notion.so/my-integrations 創建一個 Notion 集成。
2. 命名你的集成（例如：“Claude MCP Integration”）。
3. 將集成類型設置為“Internal”。
4. 複製你的 API 密鑰。
5. 通過點擊任何頁面/數據庫右上角的“...”菜單並選擇“添加連接”來共享你的 Notion 頁面和數據庫。

2. 安裝依賴項

npm install

3. 配置環境變量

在項目根目錄創建一個 .env 文件，包含你的 Notion API 密鑰：

NOTION_API_KEY=your_api_key_here

此步驟僅在你開發服務器時需要。

4. 構建

構建服務器，準備由 Claude 使用。

npm run build

如果你正在開發服務器，可以運行 npm run dev 或 npm run inspect。

5. 添加到 Claude Desktop 配置

打開 claude_desktop_config.json（導航至 Settings > Developer 並點擊 Edit Config），添加以下內容：

"notion": {
  "command": "node",
  "args": [
    "path/to/mcp-server-notion/dist/index.js"
  ],
  "env": {
    "NOTION_API_KEY": "your_notion_api_key_here"
  }
}

6. 重啟 Claude

重啟 Claude 後，你就可以開始使用了！

✨ 主要特性

該項目旨在構建一個 MCP 服務器，連接 Claude AI 和 Notion 工作區，允許 Claude：

• 從 Notion 數據庫和頁面中讀取內容
• 更新現有內容
• 在整個 Notion 工作區中搜索
• 查詢和過濾數據庫條目
• 獲取詳細頁面內容和數據庫架構

此 MCP 服務器提供以下工具：

• search_notion：使用查詢字符串在 Notion 整個工作區中搜索
• get_notion_page：獲取特定 Notion 頁面的詳細內容
• get_notion_database：獲取 Notion 數據庫的元數據和架構
• query_notion_database：支持複雜查詢，在 Notion 數據庫中搜索和過濾條目

📚 詳細文檔

資源與參考

• 官方 Notion API 文檔
• Model Context Protocol 規範
• 示例 MCP 服務器實現
• Claude 開發者文檔

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

該項目在 MIT 許可證下發布，詳細信息見 LICENSE 文件。