AI导哈

Gravatar数据访问服务

一个基于Model Context Protocol (MCP)的服务，提供对Gravatar个人资料和头像数据的访问，适用于需要集成Gravatar功能的客户端应用。

  • by andrewdmontgomery
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 andrewdmontgomery/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

  2. 安装依赖项

    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

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

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

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

生成文件目标

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

环境变量

  • GRAVATAR_API_TOKEN -您的Gravatar API密钥

相关 MCP