JinDaGe - mcp-server-gravatar MCP Details

article

README

🚀 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 客户端。

安装步骤

克隆仓库

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

安装依赖项
```
uv sync
```
此命令会依据 pyproject.toml 中指定的依赖项，将所有 Python 包安装到活动虚拟环境中。
生成 OpenAPI 客户端（若更新了 openapi.yaml）

⚠️ 重要提示

已对生成的代码进行了手动修改以修复问题。如果重新生成 openapi_client，请保留这些更改。
```
make generate
```
该命令会运行 OpenAPI Generator Docker 镜像，并将生成的 openapi_client 同步到 src/openapi_client。

📚 详细文档

配置

在 Claude Desktop 中使用

将以下内容添加到您的 claude_desktop_config.json 文件中：

使用 uvx

"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 监视器跟踪和调试提示和工具的执行，具体步骤如下：

运行监视器：

npx @modelcontextprotocol/inspector uv run mcp-server-gravatar
Starting MCP inspector...
⚙️ 代理服务器在端口 6277 上监听
🔍 MCP 监视器正在 http://127.0.0.1:6274 运行

在浏览器中打开监视器 UI
- 在上述示例中：http://localhost:6274

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

Makefile 目标

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

环境变量

GRAVATAR_API_TOKEN — 您的 Gravatar API 密钥。

mcp-server-gravatar