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 - 提供模型上下文協議

📞 支援

如有問題請：

查看 Issues
創建新的 Issue
查看文檔 docs/

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Cloudflare Workers-based service that enables intelligent searching, automatic code snippet recording, and statistical analysis of programming knowledge stored in Notion databases.

Related MCP Servers

Code Explainer MCP
BillDuke13
-
security
A
license
-
quality
A Cloudflare Worker that analyzes source code to provide comprehensive explanations including architecture diagrams, core functionality analysis, and component breakdowns across multiple programming languages.
Last updated -
4
TypeScript
Apache 2.0
Remote MCP Server
jongan69
-
security
F
license
-
quality
A Cloudflare Workers-based server implementing the Model Context Protocol that enables AI assistants like Claude to securely access external tools through OAuth authentication.
Last updated -
14
TypeScript
Remote MCP Server for Website Analysis
elizabethsiegle
-
security
F
license
-
quality
An authless Cloudflare Workers server that provides tools to scrape, analyze, and answer questions about websites using Cloudflare's Browser Rendering and AI capabilities.
Last updated -
6
TypeScript
Remote MCP Server
cyyzpanpan
-
security
F
license
-
quality
A Cloudflare Workers-based Model Context Protocol server that enables AI assistants like Claude to access external tools via OAuth authentication.
Last updated -
14
TypeScript

View all related MCP servers

Notion Knowledge MCP Server