Notion (via Dify)

🚀 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. .envファイルを作成し、Dify APIキーを追加します。

echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env

3. Clineでサーバーをインストールします。

fastmcp install notion_mcp_server.py

これにより、以下の操作が自動的に行われます。

• uvを使用してすべての必要な依存関係をインストールします。
• Cline内のサーバー設定を構成します。
• サーバーをClineで使用できるようにします。

💻 使用例

基本的な使用法

インストールが完了したら、Clineで質問することで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実行コマンドを使用していることを確認します。
   • サーバーログ内のエラーを確認します。

貢献

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

📄 ライセンス

MIT