Simple Notion MCP Server

シンプルな Notion MCP サーバー

概要

このプロジェクトは、AI アシスタントと Notion API の橋渡しをする Model Context Protocol（MCP）サーバーを実装します。大きな JSON の塊を返す公式の Notion MCP サーバーとは異なり、このサーバーは Notion ページを Markdown としてレンダリングするため、LLM が効率よく処理して理解できます。

機能

• Markdown レンダリング：Notion ページを読みやすく整った Markdown 形式に変換します
• リッチテキスト対応：太字、斜体、取り消し線、コード要素の書式を保持します

セットアップ

1. Notion インテグレーションを作成し、https://www.notion.so/my-integrations から API トークンを取得します
2. トークンを環境変数として設定します：

export NOTION_TOKEN=your-notion-api-token

または、プロジェクト内に .env ファイルを作成して、次のように設定できます：

NOTION_TOKEN=your-notion-api-token

3. アクセスする Notion ページをインテグレーションと共有してください

使用方法

VS Code での使用

設定 JSON ファイルに次の内容を追加します：

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "notion_token",
        "description": "Notion API Token",
        "password": true
      }
    ],
    "servers": {
      "notion": {
        "command": "npx",
        "args": [
          "-y",
          "@larryhudson/simple-notion-mcp-server"
        ],
        "env": {
          "NOTION_TOKEN": "${input:notion_token}"
        }
      }
    }
  }
}

Claude またはその他の MCP 互換アプリケーションでの使用

MCP 設定 JSON ファイルに次の内容を追加します：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@larryhudson/simple-notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "<YOUR_NOTION_API_TOKEN>"
      }
    }
  }
}

利用可能なツール

get_page

Notion ページを ID で取得し、Markdown としてレンダリングします。

パラメーター：

• page_id：取得する Notion ページの ID

例：

{
  "page_id": "83c75a5b7a324be29d454536f2345678"
}

仕組み

サーバーは次の手順で Notion ページを処理します：

1. Notion API を使用してページのメタデータを取得します
2. ページ内のすべてのブロックを取得します（子ブロックも再帰的に取得します）
3. 構造と書式を保ちながら、ブロックを Markdown に整形します
4. ページを整った Markdown 形式で返します

技術的な詳細

使用している技術：

• Model Context Protocol（MCP）：AI アシスタントが外部ツールと連携できるようにするフレームワーク
• Notion API Client：Notion との通信に使用する公式クライアント
• TypeScript：型安全性と開発者体験の向上に使用します

開発

Model Context Protocol インスペクターを使って、サーバーを試すことができます：

npx @modelcontextprotocol/inspector npx tsx src/index.ts

制限事項と今後の改善

• 現在はページの取得のみをサポートしています（更新や作成には対応していません）
• 今後のアップデートで画像の処理を改善できる可能性があります（例：画像を base64 画像ブロックとしてレンダリングする）

ライセンス

MIT