Notion Knowledge Base MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Used for loading environment variables from a .env file, specifically to securely store and access the Dify API key needed for the Notion knowledge base connection.

  • Provides access to a Notion knowledge base, allowing users to query their Notion content directly, receive detailed answers with references to specific Notion pages, and view related page IDs.

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

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

ライセンス

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

-
security - not tested
F
license - not found
-
quality - not tested

Notion ナレッジ ベースに接続する MCP サーバー。Cline 拡張機能を使用して VSCode から直接情報を照会および取得できます。

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Configuration
            1. Development
              1. Troubleshooting
                1. Contributing
                  1. License
                    ID: xvq6i7dram