Notion MCP Server

🚀 Notion MCP 服務器

Notion MCP 服務器是一個基於模型上下文協議（MCP）的工具，可與 Notion 平臺進行交互，支持對頁面、塊、數據庫和評論的操作。

🚀 快速開始

克隆倉庫

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

安裝依賴

npm install

設置環境變量

創建一個 .env 文件：

NOTION_TOKEN=your_notion_api_key
NOTION_PAGE_ID=your_notion_page_id

構建項目

npm run build

運行檢查工具

npm run inspector

✨ 主要特性

Notion MCP 服務器提供了對 Notion 平臺頁面、塊、數據庫和評論的操作支持，基於模型上下文協議（MCP），能高效地與 Notion 進行交互。

📦 安裝指南

1. 克隆倉庫。
2. 安裝依賴。
3. 設置環境變量。
4. 啟動服務器或檢查工具。

💻 使用示例

基礎用法

按照上述安裝指南完成安裝和配置後，即可使用 Notion MCP 服務器與 Notion 平臺進行交互。

📚 詳細文檔

開發指南

代碼結構

• index.ts：主入口文件。
• tools/：包含與 Notion API 交互的工具模塊。
• schemas/：用於輸入輸出驗證的 Zod 模式文件。
• types/：定義自定義類型和接口。

開發步驟

1. 克隆倉庫並安裝依賴。
2. 根據需要修改代碼或添加新功能。
3. 使用檢查工具調試和測試。
4. 構建項目以生成生產版本。

故障排除

常見問題

• 認證錯誤：確認 Notion 令牌具有正確的權限，並且已啟用相關頁面/數據庫的訪問。
• 頁面訪問問題：確保集成已添加到您要訪問的頁面中。
• 速率限制：優化請求，使用批處理操作以提高效率。

貢獻指南

歡迎貢獻！請按照以下步驟提交 Pull Request：

1. Fork 倉庫。
2. 創建功能分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m '添加很棒的功能')。
4. 推送到分支 (git push origin feature/amazing-feature)。
5. 提交 Pull Request。

🔧 技術細節

• 構建技術：使用 TypeScript 和 MCP SDK（版本 1.7.0+）。
• 依賴庫：集成 Notion 官方客戶端庫 (@notionhq/client，版本 2.3.0+）。
• 協議遵循：符合模型上下文協議規範。

📄 許可證

本項目遵循 MIT 許可證，詳細內容請查看 LICENSE 文件。