NotionナレッジベースMCPサーバー

Cline VSCode 拡張機能を通じて Notion ナレッジベースへのアクセスを提供する MCP サーバー。

特徴

Cline から直接 Notion ナレッジベースを照会する
Notionページを参照して詳細な回答を入手
信頼性の高いパフォーマンスを実現するFastMCPを搭載
包括的なエラー処理とログ記録

Related MCP server: Memory Box MCP Server

前提条件

Python 3.10以上
UVパッケージマネージャー
Cline VSCode拡張機能
NotionナレッジベースにアクセスするためのDify APIキー

インストール

このリポジトリをクローンします:
git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server
Dify API キーを使用して.envファイルを作成します。
echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env
Cline にサーバーをインストールします。
fastmcp install notion_mcp_server.py
これにより、次の処理が自動的に実行されます。
- uv を使用して必要な依存関係をすべてインストールします
- Clineの設定でサーバーを構成する
- Clineでサーバーを使用できるようにする

使用法

インストールが完了したら、ClineでNotionナレッジベースについて質問することでサーバーを利用できます。例えば：

Tell me about internal tooling

サーバーは、Notion ナレッジベースから次のような関連情報を返します。

詳細な回答
関連するNotionページへのリンク
参照用のページID

構成

サーバーはインストール中に自動的に構成されますが、必要に応じて Cline の構成ファイルの設定を手動で更新できます。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

構成例:

{ "mcpServers": { "notion-kb": { "command": "uv", "args": [ "run", "--with", "fastmcp", "--with", "python-dotenv", "--with", "requests", "fastmcp", "run", "/absolute/path/to/notion_mcp_server.py" ], "env": { "DIFY_API_BACKEND_KEY": "your-api-key" } } } }

発達

開発とテストの場合:

依存関係をインストールします:
pip install -r requirements.txt
開発サーバーを実行します。
fastmcp dev notion_mcp_server.py

これにより、サーバーをテストするための MCP Inspector インターフェイスが起動します。

トラブルシューティング

サーバーに接続できません
- .envファイルでAPIキーを確認してください
- Cline の設定でサーバーパスが絶対パスであることを確認する
- uvがインストールされ、PATHに入っているか確認する
依存関係の問題
- fastmcp install notion_mcp_server.py --forceで再インストールしてみてください。
- UVが正しくインストールされていることを確認する
サーバーがハングする
- 設定で指定されているとおりに uv run コマンドを使用していることを確認してください
- サーバーログでエラーを確認する