Hugging Face MCP Server

Hugging Face MCP 服务

一个 MCP（Model Context Protocol）服务，可访问 Hugging Face 的 AI 图像生成模型，包括 Stable Diffusion。

功能

• 使用多种 Stable Diffusion 模型生成图像
• 支持负面提示词和引导比例
• 将图像保存在本地或以 base64 格式返回
• 检查 API 状态和令牌有效性
• 提供免费套餐（有速率限制）

可用模型

• Stable Diffusion 2.1：高质量通用模型
• Stable Diffusion XL：最新、最先进的模型
• OpenJourney：Midjourney 风格的艺术图像
• Dreamlike Diffusion：奇幻和艺术风格
• Anything v5：动漫／漫画风格图像

安装

1. 克隆此仓库：

git clone https://github.com/nikolausm/huggingface-mcp-server.git
cd huggingface-mcp-server

2. 安装依赖项：

npm install

3. 获取 Hugging Face API 令牌：

   • 前往 https://huggingface.co/settings/tokens
   • 创建一个新令牌（免费）
   • 复制令牌

4. 设置环境变量：

export HUGGINGFACE_TOKEN="your_token_here"

在 Claude Desktop 中配置

将以下内容添加到 Claude Desktop 配置文件（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "huggingface": {
      "command": "node",
      "args": ["/path/to/huggingface-mcp-server/index.js"],
      "env": {
        "HUGGINGFACE_TOKEN": "your_token_here"
      }
    }
  }
}

用法

生成图像

// Basic usage
generate_image({
  prompt: "a cute guinea pig in a garden, children's book illustration style"
})

// Advanced usage
generate_image({
  prompt: "a beautiful landscape with mountains",
  model: "stable-diffusion-xl",
  negative_prompt: "ugly, blurry, low quality",
  guidance_scale: 10,
  save_path: "/tmp/landscape.png"
})

列出可用模型

list_models()

检查 API 状态

check_status()

免费套餐限制

• 速率限制为每分钟约 10-20 个请求
• 部分模型可能需要排队等待
• 用于生产环境时，请考虑升级到付费套餐

提升效果的技巧

1. 描述具体：“红色谷仓的水彩画”比单独写“谷仓”效果更好
2. 添加风格：加入“油画”“铅笔素描”“数字艺术”等艺术风格
3. 使用负面提示词：告诉模型要避免什么
4. 调整引导比例：较高的值（10-15）会更贴近提示词

示例

儿童读物插画

prompt: "cute guinea pig eating carrots, children's book illustration, watercolor style, soft colors"
negative_prompt: "realistic, photo, dark, scary"

教育示意图

prompt: "simple diagram of guinea pig anatomy, educational poster, labeled parts, clean design"
model: "stable-diffusion-xl"

许可证

MIT

作者

Michael Nikolaus