MCP Server for Gravatar

Gravatar 用 MCP サーバー

Gravatar のプロフィールとアバターデータにアクセスできる、stdio ベースの Model Context Protocol（MCP）サーバーです。クライアント（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 依存関係が、現在の仮想環境にインストールされます。

OpenAPI クライアントの再生成

（openapi.yaml を更新した場合）

注意

クライアントを再生成すると問題が発生します。問題を修正するため、生成されたコードには手動で変更が加えられています。 openapi_client を再生成する場合は、それらの変更を維持してください。理想的には、これらの変更を生成後の手順として適用できるとよいでしょう。

make generate

これにより OpenAPI Generator の Docker イメージが実行され、生成された gravatar_api_client/openapi_client が src/openapi_client に同期されます。

設定

Claude Desktop での使用方法

claude_desktop_config.json に次の内容を追加してください。

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/andrewdmontgomery/mcp-server-gravatar", "mcp-server-gravatar"]
  }
}

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/andrewdmontgomery/mcp-server-gravatar@add/my-feature", "mcp-server-gravatar"]
  }
}

MCP サーバーの実行

サーバーを直接起動できます。

# Run the MCP server
uv run mcp-server-gravatar

起動時の問題をデバッグする際に役立ちます。

uvx を使って、リポジトリからサーバーを起動することもできます。

uvx --from git+https://github.com/andrewdmontgomery/mcp-server-gravatar mcp-server-gravatar

ブランチを指定することもできます（例：add/my-feature）。

uvx --from git+https://github.com/andrewdmontgomery/mcp-server-gravatar@add/my-feature mcp-server-gravatar

MCP Inspector を使ったデバッグ

MCP Inspector を使用して、プロンプトやツールの実行を追跡し、デバッグできます。例：

1. Inspector を実行します。

   make inspector
   

   または、手動で実行します。

   npx @modelcontextprotocol/inspector uv run mcp-server-gravatar
   Starting MCP inspector...
   ⚙️ Proxy server listening on port 6277
   🔍 MCP Inspector is up and running at http://127.0.0.1:6274
   

2. ブラウザーで Inspector の UI を開きます。

   • 上記の例では、http://localhost:6274 です。

詳しくは、公式ドキュメントを参照してください。
https://modelcontextprotocol.io/docs/tools/inspector

Makefile のターゲット

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

環境変数

• GRAVATAR_API_TOKEN — Gravatar API キー