Notion Knowledge MCP Server
🚀 基於 Cloudflare Workers 的 Notion 知識庫 MCP 服務器，專為程式開發知識管理設計
✨ 特色功能
- 🔍 智能搜索 - 在 Notion 知識庫中快速找到相關內容
- 📝 自動記錄 - Claude Code Hooks 自動保存代碼片段
- 📊 統計分析 - 知識庫內容統計和趨勢分析
- 🌐 全球加速 - Cloudflare CDN 確保極速響應
- 🔒 安全可靠 - 環境變數加密存儲，API Token 安全管理
🚀 快速開始
1. 部署到 Cloudflare Workers
方法一：一鍵部署
方法二：手動部署
# 克隆倉庫
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
- 前往 Notion Integrations
- 創建新的 Integration
- 複製 Integration Token
- 創建或選擇一個 Notion 資料庫作為知識庫
- 複製資料庫 ID（從資料庫 URL 中獲取）
- 在你的知識庫頁面授權 Integration
2.1 部署到 Cloudflare Workers（可選）
如果要部署到 Cloudflare Workers：
# 設置環境變數
wrangler secret put NOTION_TOKEN # 你的 Notion Integration Token
wrangler secret put NOTION_DATABASE_ID # 你的 Notion 資料庫 ID
# 部署
wrangler deploy
3. 配置 AI 客戶端
Claude Desktop
# 複製配置檔案
cp config/claude-desktop.json ~/Library/Application\ Support/Claude/claude_desktop_config.json
Claude Code
# 使用 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
# 安裝 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 工具調用
🛠️ 開發
本地開發
npm run dev
測試
npm test
部署
npm run deploy
📝 配置
環境變數
NOTION_TOKEN- Notion Integration Token (必須)NOTION_DATABASE_ID- Notion 資料庫 ID (必須)
自定義配置
編輯 wrangler.toml 來自定義部署設定
🤝 貢獻
歡迎提交 Issue 和 Pull Request！
- Fork 這個倉庫
- 創建你的功能分支 (
git checkout -b feature/AmazingFeature) - 提交你的修改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打開一個 Pull Request
📄 授權
這個專案使用 MIT 授權 - 查看 LICENSE 文件了解詳情
🙏 致謝
- Cloudflare Workers - 提供無服務器運行環境
- Notion API - 提供強大的知識庫 API
- Claude MCP - 提供模型上下文協議
📞 支援
如有問題請：