MCP Server Gravatar

🚀 Gravatar 的 MCP 服务器

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 命令）。
• （可选）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 包安装到活动虚拟环境中。

3. 生成 OpenAPI 客户端（若更新了 openapi.yaml）

   ⚠️ 重要提示

   已对生成的代码进行了手动修改以修复问题。如果重新生成 openapi_client，请保留这些更改。

   make generate
   

   该命令会运行 OpenAPI Generator Docker 镜像，并将生成的 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-git"]
  }
}

运行 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 密钥。