MCP Server for Gravatar

Gravatar MCP 服务

一个基于 stdio 的模型上下文协议（MCP）服务，可访问 Gravatar 个人资料和头像数据。客户端（例如 Claude Desktop、自定义 IDE 插件）可以通过 MCP 发现并调用工具，以获取 Gravatar 个人资料和头像。

功能

• 按电子邮件地址或 SHA256 哈希获取 Gravatar 个人资料
• 获取指定的个人资料字段
• 列出用户头像并获取头像图像字节
• 通过 stdio 运行，便于与支持 MCP 的客户端集成

先决条件

• Python 3.10 或更高版本
• 已安装 uv 命令行工具（提供 uv sync 和 uv run）
• （可选）Docker，如果需要通过 make generate 重新生成 OpenAPI 客户端

设置

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 密钥