Notion Knowledge MCP Server

# Notion Knowledge MCP Server > 🚀 基於 Cloudflare Workers 的 Notion 知識庫 MCP 服務器，專為程式開發知識管理設計 [](https://deploy.workers.cloudflare.com/?url=https://github.com/etjang10/notion-knowledge-mcp) [](https://opensource.org/licenses/MIT) ## ✨ 特色功能 - 🔍 **智能搜索** - 在 Notion 知識庫中快速找到相關內容 - 📝 **自動記錄** - Claude Code Hooks 自動保存代碼片段 - 📊 **統計分析** - 知識庫內容統計和趨勢分析 - 🌐 **全球加速** - Cloudflare CDN 確保極速響應 - 🔒 **安全可靠** - 環境變數加密存儲，API Token 安全管理 ## 🚀 快速開始 ### 1. 部署到 Cloudflare Workers #### 方法一：一鍵部署 [](https://deploy.workers.cloudflare.com/?url=https://github.com/etjang10/notion-knowledge-mcp) #### 方法二：手動部署 ```bash # 克隆倉庫 git clone https://github.com/etjang10/notion-knowledge-mcp.git cd notion-knowledge-mcp # 安裝依賴 npm install # 登入 Cloudflare npx wrangler login # 設定環境變數 npx wrangler secret put NOTION_TOKEN npx wrangler secret put NOTION_DATABASE_ID # 部署 npm run deploy ``` ### 2. 配置 Notion 1. 前往 [Notion Integrations](https://www.notion.so/my-integrations) 2. 創建新的 Integration 3. 複製 Integration Token 4. 創建或選擇一個 Notion 資料庫作為知識庫 5. 複製資料庫 ID（從資料庫 URL 中獲取） 6. 在你的知識庫頁面授權 Integration ### 2.1 部署到 Cloudflare Workers（可選） 如果要部署到 Cloudflare Workers： ```bash # 設置環境變數 wrangler secret put NOTION_TOKEN # 你的 Notion Integration Token wrangler secret put NOTION_DATABASE_ID # 你的 Notion 資料庫 ID # 部署 wrangler deploy ``` ### 3. 配置 AI 客戶端 #### Claude Desktop ```bash # 複製配置檔案 cp config/claude-desktop.json ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` #### Claude Code ```bash # 使用 claude mcp add 命令（推薦） claude mcp add notion-knowledge node ./src/mcp-server.js # 或手動配置：將以下內容添加到 ~/.claude/settings.json { "mcpServers": { "notion-knowledge": { "command": "node", "args": ["<path-to-project>/src/mcp-server.js"] } } } ``` #### Gemini CLI ```bash # 安裝 Gemini CLI npm install -g @google/gemini-cli # 配置 MCP 服務器 cp config/gemini-cli-settings.json ~/.gemini/settings.json # 或將 notion-knowledge 配置合併到現有的 ~/.gemini/settings.json ``` ## 📖 使用指南 ### 基本操作 **搜索知識：** ``` 請搜索關於 "React Hooks" 的知識 ``` **添加知識：** ``` 請將這段代碼保存到知識庫： [你的代碼] ``` **查看統計：** ``` 請顯示知識庫統計信息 ``` ### API 端點 - `GET /health` - 健康檢查 - `GET /tools` - 工具列表 - `POST /call` - MCP 工具調用 ## 🛠️ 開發 ### 本地開發 ```bash npm run dev ``` ### 測試 ```bash npm test ``` ### 部署 ```bash npm run deploy ``` ## 📝 配置 ### 環境變數 - `NOTION_TOKEN` - Notion Integration Token (必須) - `NOTION_DATABASE_ID` - Notion 資料庫 ID (必須) ### 自定義配置 編輯 `wrangler.toml` 來自定義部署設定 ## 🤝 貢獻 歡迎提交 Issue 和 Pull Request！ 1. Fork 這個倉庫 2. 創建你的功能分支 (`git checkout -b feature/AmazingFeature`) 3. 提交你的修改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 打開一個 Pull Request ## 📄 授權 這個專案使用 MIT 授權 - 查看 [LICENSE](LICENSE) 文件了解詳情 ## 🙏 致謝 - [Cloudflare Workers](https://workers.cloudflare.com/) - 提供無服務器運行環境 - [Notion API](https://developers.notion.com/) - 提供強大的知識庫 API - [Claude MCP](https://modelcontextprotocol.io/) - 提供模型上下文協議 ## 📞 支援 如有問題請： 1. 查看 [Issues](https://github.com/etjang10/notion-knowledge-mcp/issues) 2. 創建新的 Issue 3. 查看文檔 [docs/](docs/) --- **Live Demo**: https://notion-knowledge.etjang10.workers.dev