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 密鑰。