Chrome MCP Server Ngg

🚀 Chrome MCP サーバー

このプロジェクトでは、Chromeとのインタラクションを目的としたサーバーを構築しています。主な目標は以下の2点です。

1. Anthropicが提供するMCPライブラリに依存しないMCP実装を提供する。
2. Chrome MCPサーバーを作成し、Cursorで使用してページのスクリーンショットを取得し、その実装を検証する。

⚠️ 重要提示

これはMCPプロトコルの参考実装ではありません。プロトコルとその動作原理をより深く理解するための学習用の練習です。

より堅牢な実装は app フォルダにあります。

✨ 主な機能

• 独立したMCP実装を提供することで、Anthropicのライブラリに依存せずにChromeとのインタラクションが可能になります。
• Chrome MCPサーバーを通じて、Cursorでページのスクリーンショットを取得し、実装を検証することができます。

📦 インストール

本プロジェクトでは特にインストール手順は記載されていませんが、以下の実行コマンドを使用するために必要な依存関係を事前にインストールする必要があります。

💻 使用例

基本的な使用法

デモ実装の実行

uv run uvicorn demo_implementation.main:app --reload

MCPチェックツールでのテスト

npx @modelcontextprotocol/inspector node build/index.js

チェックツールでの接続

チェックツールでは、URL http://0.0.0.0:8000 を使用してサーバーに接続できます。

高度な使用法

堅牢な実装の起動

# サーバーの起動
mcp run app/main.py --transport sse

MCPチェックツールの起動

npx @modelcontextprotocol/inspector node build/index.js

📚 ドキュメント

デモ実装の仕組み

デモ実装には主に2つの主要なコンポーネントがあります。

1. サーバーからクライアントにメッセージを送信するためのイベントストリーム。
2. クライアントからサーバーにメッセージを送信するためのPOSTエンドポイント。

初期化フローは3つの部分に分かれています。

1. クライアントが最初に /sse エンドポイントを呼び出してセッションURIを取得します。
2. クライアントがサーバーに initialize メッセージを送信し、サーバーはサポートする機能を応答します。
3. クライアントが notifications/initialized メッセージを送信して、サーバーに初期化が完了したことを通知します。

実装が完了すると、クライアントはサーバーにメッセージを送信してツールを使用できます。

デモ実装の制限

デモ実装にはいくつかの制限があります。エラーハンドリングの欠如や、セッションの適切なクリーンアップが行われていないなどが挙げられます。app/main.py には、MCP Python SDKに依存して接続とメッセージを処理する、より堅牢な実装が追加されています。

堅牢な実装の仕組み

堅牢な実装はMCP Python SDKに依存して接続とメッセージを処理します。この実装は app/main.py にあります。

実装は、ツールとして使用する3つの関数を定義するだけで済むため、はるかに簡単です。これらの関数が定義されたら、上記のコマンドを実行して実装をテストできます。