MCP Server Gravatar

🚀 GravatarのMCPサーバ

標準入出力（stdio）に基づくModel Context Protocol (MCP) サーバで、Gravatarのプロフィールとアバターデータへのアクセスを提供します。クライアント（例：Claude Desktop、カスタムIDEプラグイン）は、MCPプロトコルを通じてこのツールを発見し、Gravatarのプロフィールとアバターを取得するために呼び出すことができます。

✨ 主な機能

• メールアドレスまたはSHA256ハッシュを使用してGravatarのプロフィールを取得します。
• 特定のプロフィールフィールドを検索します。
• ユーザーのアバターを一覧表示し、アバター画像のバイトデータを取得します。
• stdioで実行されるため、MCPに対応したクライアントとの統合が容易です。

📦 インストール

前提条件

• Python 3.10以上
• uv CLIツールがインストールされていること（uv sync と uv run コマンドを提供します）
• （オプション）make generate でOpenAPIクライアントを再生成する場合は、Dockerが必要です。

セットアップ

1. リポジトリをクローンする

   git clone https://github.com/andrewdmontgomery/mcp-server-gravatar.git
   cd mcp-server-gravatar
   

2. 依存関係をインストールする

   uv sync
   

   このコマンドは、pyproject.toml で指定された依存関係に基づいて、すべてのPythonパッケージをアクティブな仮想環境にインストールします。
3. OpenAPIクライアントを生成する（openapi.yaml を更新した場合）

   ⚠️ 重要提示

   生成されたコードには手動で修正が加えられています。openapi_client を再生成する場合は、これらの変更を保持してください。

   make generate
   

   このコマンドは、OpenAPI GeneratorのDockerイメージを実行し、生成された openapi_client を src/openapi_client に同期します。

設定

Claude Desktopでの使用

以下の内容を claude_desktop_config.json ファイルに追加してください。

MCPサーバの実行

モジュールとして直接サーバを実行することができます。

# MCPサーバを起動する
uv run -m mcp_server_gravatar

MCPモニターを使用したデバッグ

MCPモニターを使用して、プロンプトとツールの実行を追跡およびデバッグすることができます。例えば：

1. モニターを実行する：

   npx @modelcontextprotocol/inspector uv run mcp-server-gravatar
   Starting MCP inspector...
   ⚙️ 代理サーバはポート6277で待機中です
   🔍 MCPモニターは http://127.0.0.1:6274 で実行中です
   

2. ブラウザでモニターUIを開く
   • 上記の例では：http://localhost:6274 詳細については、公式ドキュメントを参照してください： https://modelcontextprotocol.io/docs/tools/inspector

Makefileのターゲット

• make generate — OpenAPIクライアントを再生成して同期します。
• make clean — 生成されたクライアントファイルを削除します。

環境変数

• GRAVATAR_API_TOKEN — あなたのGravatar APIキー