Notion Knowledge Base MCP Server

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

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

特徴

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

前提条件

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

インストール

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

使用法

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

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

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

構成

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

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

構成例:

発達

開発とテストの場合:

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

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

トラブルシューティング

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

貢献

サーバーの実装とアーキテクチャの詳細については、 mcp_instructions.md を参照してください。

ライセンス

マサチューセッツ工科大学