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

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

特徴

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

Related MCP server: Memory Box MCP Server

前提条件

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

インストール

このリポジトリをクローンします:

git clone https://github.com/yourusername/notion-mcp-server.git
cd notion-mcp-server

Dify API キーを使用して.envファイルを作成します。
```
echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env
```
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"
      }
    }
  }
}

発達

開発とテストの場合:

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

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

トラブルシューティング

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