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 でサーバーを使用できるようにします

使用方法

インストール後、Notion ナレッジベースについて質問すると、Cline でサーバーを使用できます。たとえば、次のように質問できます。

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

ライセンス

MIT