MCP Server Gravatar

Gravatar的MCP服务器

基于stdio的模型上下文协议（MCP）服务器，提供对Gravatar配置文件和化身数据的访问。客户端（如Claude Desktop、自定义IDE插件）可以通过MCP发现和调用工具，以获取Gravatar配置文件和头像。

特性

• 通过电子邮件或SHA256哈希获取Gravatar配置文件
• 检索特定配置文件字段
• 列出用户头像并获取头像图像字节
• 通过stdio工作，可轻松与支持MCP的客户端集成

先决条件

• Python 3.10或更高版本
• 紫外线 已安装CLI工具（提供 uv sync 和 uv run)
• （可选）Docker，如果你需要通过以下方式重新生成OpenAPI客户端 make generate

设置

1. 克隆存储库

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

1. 安装依赖项

   uv sync

这将安装中指定的所有Python依赖项 pyproject.toml 进入您的活动虚拟环境。

重新生成OpenAPI客户端

（如果您已更新 openapi.yaml)

\[！小心\] 重新生成客户端将导致问题。为了解决问题，对生成的代码进行了手动更改。 如果重新生成openapi_client，则应保留这些更改。理想情况下，这些变化将作为后一代步骤应用。

make generate

这将运行OpenAPI生成器Docker映像并同步生成的 gravatar_api_client/openapi_client 进入 src/openapi_client.

配置

使用Claude Desktop

将此添加到您的 claude_desktop_config.json:

Using uvx

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

或者，如果你想加载一个特定的分支（例如。 add/my-feature):

"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，您还可以从repo启动服务器：

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检查器进行调试

您可以使用MCP检查器跟踪和调试提示和工具执行。例如：

1. 运行检查器：

   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

1. 在浏览器中打开检查器UI

- 在上述示例中： http://localhost:6274.

有关更多详细信息，请参阅官方文档：\ https://modelcontextprotocol.io/docs/tools/inspector

生成文件目标

• make generate --重新生成并同步OpenAPI客户端
• make clean --删除生成的客户端文件

环境变量

• GRAVATAR_API_TOKEN -您的Gravatar API密钥

______________________________________________________________________