AI OS MCP Server

Felix の AI OS(Notion と同期)を MCP ツールとして公開します。これにより、MCP 互換の AI クライアントは公開リンクをスクレイピングする代わりに、直接クエリを実行できます。

正直な制限: これは、実際に npm install してコンパイルテストする環境がないまま書かれています(作成環境にはネットワークアクセスがありません)。現時点で判明している現在の MCP TypeScript SDK と Notion クライアント API の形状には沿っていますが、信頼する前にビルド手順を自分で実行し、エラーを確認してください — 丁寧に書かれたからといって完璧であるとは期待しないでください。

公開するツール

• search_vault(query) — AI OS 全体を対象にしたキーワード検索

• get_page(page_name) — 指定した名前のページ全体を取得

• list_projects() — 10_Projects インデックスページの現在の内容

• get_project_status(project_name) — 特定のプロジェクトの現在のステータス取得

Related MCP server: nooon

セットアップ

1. Notion インテグレーションを作成する

notion.so/my-integrations にアクセス → 新規インテグレーション → 名前を付けます(例:「AI OS MCP」) → 「内部インテグレーションシークレット」( secret_ または ntn_ で始まる)をコピーします。

2. このインテグレーションと AI OS を共有する

Notion の AI OS ルートページを開きます → ... メニュー → Connections → 作成したインテグレーションを追加します。これは「Web に共有」とは別物で、実際にインテグレーションの API 呼び出しがページを表示できるようにする設定です。

3. API キーを設定する

cp .env.example .env
# paste your key into .env

4. Docker でビルドして実行する

docker compose build
docker compose run --rm ai-os-mcp

このサーバーは stdio 上で動作します。MCP クライアント(Claude Desktop など)から起動されることを想定しており、ターミナルで長時間起動しっぱなしにするためのものではありません。

5. MCP クライアントに接続する

Claude Desktop の場合は、MCP 設定(claude_desktop_config.json)に以下の項目を追加します:

{
  "mcpServers": {
    "ai-os": {
      "command": "docker",
      "args": ["compose", "-f", "/full/path/to/ai-os-mcp/docker-compose.yml", "run", "--rm", "ai-os-mcp"]
    }
  }
}

信頼する前に確認すべきこと

• npm install はきれいに成功するか、それとも SDK とのバージョン不一致があるか?

• npm run build はエラーなくコンパイルできるか?

• search_vault は実際に結果を返すか — これはインテグレーションが正しいページに共有されているかどうか(ステップ 2)に依存します。

• get_page のテーブル内容は大まかな表示になる可能性があります。Notion のブロック API はネストしており、この実装ではテーブル行を 1 階層分だけ取得しているため、深く検証できていません。

This Toolが実装しないこと

書き込み・編集は行いません — 読み取り専用で設計されているため、誤って vault を変更することはありません。自動化トリガーもありません — リクエスト時に MCP クライアントから呼び出される必要があり、これは AI OS の「手動・チャットトリガー」という実行方針と一致しています。