MCP-dump

概要

Agent MCP Registry は、個別にドキュメント化された Model Context Protocol の実装と統合パターンを集めた、拡充中のコレクションです。エージェントとツールのインターフェース、サーバー、クライアントがどのように連携するかを調べる開発者を対象としています。現在、最も完成度の高い利用方法は、ファイル操作を設定済みのワークスペース内に限定する Python FastMCP サーバーです。

このリポジトリには、単体で動作するメール検証 MCP、TypeScript Cloudflare Worker、Gemini と LangGraph のクライアント例、外部の Postgres MCP サーバーを想定した Azure OpenAI エージェントも含まれています。これらのサンプルは、ひとつのデプロイ可能なアプリケーションを構成するものではなく、それぞれ成熟度が異なります。

レジストリの拡充に伴い、エントリー、ランタイム、統合内容は変更される可能性があります。各エントリーは、現在の機能と制限事項が明確に分かるよう、個別にドキュメント化されています。

カタログの方針

レジストリでは、ひとつの統合アイデアを簡単に確認、応用、置き換えられる、自己完結型のエントリーを追加していきます。今後は、ローカルおよびホスト型のサーバー、クライアントのパターン、ツールの安全性、評価用ヘルパー、デプロイ方法などを扱うエントリーを追加する予定です。

利用可能なものとして紹介するのは、チェックイン済みでドキュメントが用意された実装のみです。現在このリポジトリに含まれている内容については、以下のカタログを正としてください。

クイックスタート

最も手軽に試せる自己完結型の手順では、Python ファイルサーバーを起動します。Python 3.13 以降と`uv`が必要です。

```bash git clone https://github.com/jayanth-mkv/agent-mcp-registry.git cd agent-mcp-registry/mcp-files uv sync uv run mcp-server --help uv run mcp-server ```

サーバーは SSE を使用して `127.0.0.1:8000` でリッスンし、デフォルトではツールの操作を `workspace/` 内に限定します。必要に応じて、これらの値を変更してください。

```bash uv run mcp-server --host 0.0.0.0 --port 9001 --workspace ./data ```

CLI では、`http` と `stdio` のトランスポートも利用できます。認証レイヤーはないため、信頼できないネットワークにサーバーを公開しないでください。

メール検証 MCP

独立した`mcp-email-validator`サーバーは、メールを送信せずに構文と DNS のメールルートを検査します。SMTP の宛先プローブはデフォルトで無効になっており、評価する権限を持つアドレスとインフラストラクチャに対してのみ有効にしてください。

```bash cd mcp-email-validator uv sync uv run mcp-email-validator --transport stdio ```

現在のカタログ

パス	ステータス	コードの実装内容
`mcp-files/mcp-server`	実装済み、実験的	ファイル、ディレクトリ、検索、メタデータ、ワークスペース統計に関する14個のツールを備えたFastMCPサーバーです。
`mcp-email-validator`	実装済み、実験的	構文、DNSメールルート、およびオプトインで範囲を制限したSMTP受信者チェックを行うFastMCPサーバーです。
`mcp-files/examples/clients`	実験的	ローカルSSEサーバーを対象とする、プレーンなFastMCP、Gemini、LangGraphのクライアント例です。
`mcp-hello`	実装済み、実験的	挨拶と現在時刻を返すCloudflare Workerのメソッドです。`workers-mcp`経由でルーティングされます。
`mcp-postgres`	実験的、サービス依存	別途ホストされたPostgres MCPエンドポイントからツールを読み込むAzure OpenAI ReActエージェントです。
`mcp-files/mcp-hello`	ドキュメントのスタブ	Workerの例に関する説明です。TypeScriptの実装自体はリポジトリのルートにあります。

Pythonファイルツール

ローカルサーバーは、次の操作を実装しています。

• パスの作成、読み取り、上書き、追記、コピー、移動、名前変更、削除。
• ファイルとディレクトリの一覧表示、テキストファイルの検索、パスの存在確認。
• ファイルのメタデータとワークスペースの集計統計をJSONで返します。
• 設定されたワークスペースの外部に解決されるパスを拒否します。

`delete_path`は、そのワークスペース内のディレクトリを再帰的に削除します。サーバーへのアクセスは、設定されたディレクトリへの書き込みアクセスとして扱ってください。

オプションのエージェントクライアント

ファイルサーバーを先に起動してから、Google連携のいずれかの例を実行する前に`GOOGLE_API_KEY`を設定します。

```bash cd mcp-files uv run examples/clients/gemini.py

or

uv run examples/clients/react_agent.py ```

Postgresの例では、別途Azure OpenAIの認証情報と`MCP_RENDER_URL`が必要です。この例には、接続先のPostgres MCPサーバーは含まれておらず、起動もされません。

アーキテクチャ

各カタログ項目でエントリーポイントとトランスポートは異なりますが、実装されている処理の流れは同じです。呼び出し元がMCP境界に到達し、そのエントリーが提供するツールを呼び出して、ランタイム固有の結果を受け取ります。

成熟度と不足点

このレジストリは現在も成熟の途上にあり、バージョン管理された製品ではありません。利用を始める前に、チェックイン済みコードに次の不整合があることに注意してください。

• `mcp-files/examples/clients/base.py`は`filename`を指定して`create_file`を呼び出しますが、サーバーツールで必須なのは`path`です。
• Cloudflare Workerのテストでは、引き続き初期状態の応答`Hello World!`を検証しますが、現在のWorkerはリクエストを`ProxyToSelf`経由で委譲します。
• すべての実験をインストール、実行、テストするルートコマンドはありません。
• 一部のネストされたドキュメントでは、リポジトリ内の別の場所にあるファイルについて説明しています。

制限事項

• ファイルサーバーには、認証、認可ポリシー、クォータ、自動テストがありません。
• メール検証サーバーは、メールボックスの所有権や配信可能性を保証するものではありません。SMTPプローブはオプトインで範囲が制限されており、全受信メールを受け入れる設定や不正利用対策の影響を受けることがあります。
• テキストツールはUTF-8を前提としており、バイナリファイルや非常に大きなファイル向けには設計されていません。
• Gemini、LangGraph、Azure OpenAI、Postgres MCP、Cloudflareの各連携では、外部の認証情報またはサービスが必要です。
• Postgresの例にはローカルの依存関係マニフェストがないため、そのフォルダーだけでは環境を再現できません。
• `mcp-files/`と`mcp-email-validator/`にはそれぞれ独自のライセンスファイルがありますが、リポジトリのルートでは現在、コレクション全体の再利用条件が示されていません。

開発

TypeScript のサンプルでは、`mcp-hello/package.json` でチェックを宣言しています：

```bash cd mcp-hello npm ci npm test -- --run ```

このテストコマンドを検証ゲートとして合格扱いにする前に、古くなった Worker のアサーションを更新してください。新しい Python ツールは`tools.py`に追加し、パスの制限と破壊的操作に関する的を絞ったテストを含めてください。