YuHuanHsu/notion-knowledge-mcp

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

1. 前往 Notion Integrations
2. 創建新的 Integration
3. 複製 Integration Token
4. 創建或選擇一個 Notion 資料庫作為知識庫
5. 複製資料庫 ID（從資料庫 URL 中獲取）
6. 在你的知識庫頁面授權 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！

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 授權 - 查看 文件了解詳情

🙏 致謝

• Cloudflare Workers - 提供無服務器運行環境
• Notion API - 提供強大的知識庫 API
• Claude MCP - 提供模型上下文協議

📞 支援

如有問題請：

1. 查看 Issues
2. 創建新的 Issue
3. 查看文檔

Live Demo: https://notion-knowledge.etjang10.workers.dev