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

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

特徴

• Cline から直接 Notion ナレッジベースを照会する

• Notionページを参照して詳細な回答を入手

• 信頼性の高いパフォーマンスを実現するFastMCPを搭載

• 包括的なエラー処理とログ記録

Related MCP server: Notion MCP Server

前提条件

• 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ナレッジベースについて質問することでサーバーを利用できます。例えば：

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"
      }
    }
  }
}

発達

開発とテストの場合:

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 を参照してください。

ライセンス

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