Skip to main content
Glama
Sign In
browser-ai-rag

browser-ai-rag

by ekiyo55
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

browser-ai-rag

『ブラウザのAIが社内で働きだす ― MCPで作る文書検索・メール・勤怠』（江藤 潔）のサンプルです。

claude.ai や chatgpt.com のような、ブラウザで使う AI から呼ばれるリモート MCP サーバーを作ります。本の章が進むごとにこのリポジトリも育っていき、社内文書の検索、メールの確認と返信、タイムカードなど、いくつもの MCP サーバーがそろいます。特定の AI サービスには寄せていないので、リモート MCP に対応したサービスならどれからでもつながります。

本の全30章ぶんがそろっています。章ごとの対応とタグは docs/chapters.md を見てください。

サーバー

起動

URL

章

社内文書検索（ログインもここ）

python -m browser_ai_rag

/mcp

第3部

メール

python -m browser_ai_rag.mail_server

/mail/mcp

第20〜22章

タイムカード

python -m browser_ai_rag.timecard_server

/timecard/mcp

第23〜24章

売上・案件

python -m browser_ai_rag.count_server

/count/mcp

第26章

予定とタスク

python -m browser_ai_rag.schedule_server

/schedule/mcp

第27章

運用の窓口

python -m browser_ai_rag.ops_server

/ops/mcp

第28章

六本をまとめた一本（実験）

python -m browser_ai_rag.combined_server

/all/mcp

第29章

動かしてみる

Python 3.11 以上と uv を使います。

uv sync
uv run python -m browser_ai_rag

http://127.0.0.1:8000/mcp で待ち受けます。テストは uv run pytest で走ります。

Related MCP server: business-central-mcp

ブラウザの AI からつなぐ

ブラウザの AI は、あなたのパソコンに直接つなぎに来るわけではありません。AI の会社のクラウドが、インターネット越しにこのサーバーを呼びに来ます。なので、手元で動かしているうちはトンネルで外から届くようにします。

cloudflared tunnel --url http://127.0.0.1:8000

表示された https://xxxx.trycloudflare.com のホスト名を .env に書いて、サーバーを起動し直します。

RAG_PUBLIC_HOSTS=xxxx.trycloudflare.com

これを忘れると、AI 側からは「つながらない」とだけ出て、サーバーのログには 421（Invalid Host header）が残ります。いちばんよく踏む落とし穴です。

あとは https://xxxx.trycloudflare.com/mcp を、使っている AI のコネクタ設定に登録します。サービスごとの手順は docs/connect.md にまとめています。登録できたら、AI に「whoami ツールを使って」と頼んでみてください。Claude からなら Claude の、ChatGPT からなら ChatGPT のクライアント名が返ってきます。同じサーバーに、別々の AI がつながっているのがわかります。

設定

.env.example をコピーして .env を作ります。

変数

既定値

意味

RAG_HOST

127.0.0.1

待ち受けるアドレス

RAG_PORT

8000

待ち受けるポート

RAG_PUBLIC_HOSTS

なし

外から呼ばれるときのホスト名（カンマ区切り）

RAG_LOG_HANDSHAKE

なし

1 で AI の自己紹介の本文をログに残す（道具の引数は残さない）

RAG_BASE_URL

なし

公開する URL。設定するとログイン（OAuth）が有効になる

RAG_DATA_DIR

data

文書・索引・各サーバーのデータベースの置き場所

メール・タイムカード・売上・予定・運用の窓口の設定は、.env.example に章ごとにまとめてあります。

ライセンス

Apache License 2.0

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • business-central-mcp

      keithdev21
      A
      license
      A
      quality
      D
      maintenance
      MCP server that provides AI assistants direct access to Microsoft Dynamics 365 Business Central using its native WebSocket protocol, enabling page navigation, data operations, actions, and report execution without OData or browser automation.
      14
      468 npm
      MIT

    • business-central-mcp

      masoniqbal777
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that gives AI assistants direct access to Microsoft Dynamics 365 Business Central via its native WebSocket protocol, enabling page operations, data reading/writing, actions, search, reports, and more.
      468 npm
      MIT

    • Volante

      Be-Aesthetics
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI apps to connect to any local or remote MCP server through one local endpoint, with per-server permissions, tool prefixes, and an activity log. Supports one-click connections to multiple AI clients and imports servers already configured in those apps.
      2
      MIT