Civitai MCP Server

Civitai MCP服务器

一个模型上下文协议（MCP）服务器，为人工智能助手提供对Civitai庞大的人工智能模型、创建者和生成内容的全面访问。通过您最喜欢的兼容MCP的AI助手无缝浏览、搜索和发现AI模型。

 ](https://nodejs.org/) 

特性

🔍 模型发现

• 高级搜索：通过按类型、创建者、标签等灵活过滤来查找AI模型
• 浏览分类：按类型探索模型（检查点、LoRA、ControlNet等）
• 流行&趋势：发现下载量最大、评价最高的型号
• 最新款式：了解最新上传的模型
• 哈希查找：通过文件哈希查找模型以进行验证

👨‍💻 创作者与社区

• 创建者档案：浏览和搜索模型创建者
• 创作者收藏：查看特定创建者的所有模型
• 标签系统：通过Civitai的全面标签系统探索模型

🖼️ 生成内容

• 图片库：使用详细的元数据浏览AI生成的图像
• 生成参数：访问提示、设置和型号信息
• 社区展示：发现社区中鼓舞人心的创作

📊 模型智能

• 详细型号信息：完整的型号规格、版本和文件
• 版本历史记录：跟踪模型更新和改进
• 下载URL：通过身份验证支持直接访问模型下载
• 内容安全：访问泡菜和病毒安全扫描结果

安装

先决条件

• Node.js 18+
• npm或纱线
• Civitai API密钥（可选，但建议用于更高的速率限制）

快速开始

1. 克隆存储库：

git clone https://github.com/Cicatriiz/civitai-mcp-server.git
cd civitai-mcp-server

1. 安装依赖项：

npm install

1. 构建服务器：

npm run build

1. 设置API密钥（可选）：

export CIVITAI_API_KEY="your_api_key_here"

1. 运行服务器：

npm start

获取Civitai API密钥

1. 访问 Civitai API密钥
2. 登录您的Civitai帐户
3. 生成新的API密钥
4. 复制密钥并将其设置为环境变量

配置

MCP客户端设置

将服务器添加到MCP客户端配置中：

克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "civitai": {
      "command": "node",
      "args": ["/path/to/civitai-mcp-server/dist/index.js"],
      "env": {
        "CIVITAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

其他MCP客户端

根据客户的文档进行配置，使用：

• 命令: node /path/to/civitai-mcp-server/dist/index.js
• 运输：stdio
• 环境: CIVITAI_API_KEY=your_key

使用示例

基本型号搜索

Search for SDXL LoRA models related to anime:
- Tool: search_models
- Query: "anime"
- Types: ["LORA"]
- BaseModels: ["SDXL 1.0"]

查找热门模特

Get the most downloaded models this week:
- Tool: get_popular_models
- Period: "Week"
- Limit: 10

型号详细信息

Get comprehensive information about a specific model:
- Tool: get_model
- ModelId: 12345

浏览生成的图像

Explore recent AI-generated images:
- Tool: browse_images
- Sort: "Newest"
- Limit: 50
- NSFW: "None"

可用工具

api参考

模型类型

• Checkpoint -全稳定扩散模型
• LORA -低等级适应模型
• TextualInversion -嵌入模型
• Hypernetwork -超级网络模型
• ControlNet -ControlNet模型
• AestheticGradient -审美梯度模型
• Poses -姿势模型

排序选项

• Highest Rated -最佳社区评级
• Most Downloaded -最受欢迎的下载
• Newest -最近上传

时间段

• AllTime -无时间限制
• Year -过去12个月
• Month -过去30天
• Week -过去7天
• Day -过去24小时

API覆盖范围

此MCP服务器实现所有主要的Civitai API v1端点：

• ✅ /api/v1/models -列出和搜索模型
• ✅ /api/v1/models/:id -获取特定型号
• ✅ /api/v1/model-versions/:id -获取型号版本
• ✅ /api/v1/model-versions/by-hash/:hash -按哈希值获取版本
• ✅ /api/v1/images -浏览图片
• ✅ /api/v1/creators -列表创建者
• ✅ /api/v1/tags -列表标签
• ✅ 下载支持身份验证的URL

支持的型号类型

• 检查点：完全稳定扩散模型
• 劳拉：低等级适应模型
• 文本反转：文本反转嵌入
• 超网络：超级网络模型
• 美学渐变：美学渐变模型
• 现场总线：ControlNet型号
• 姿势：姿势模型

内容过滤

服务器支持Civitai的内容过滤系统：

• NSFW内容级别（无、软、成熟、X）
• 商业使用许可
• 模型许可选项

错误处理

该服务器包括全面的错误处理功能，用于：

• API速率限制
• 网络连接问题
• 无效参数
• 身份验证错误
• 数据验证

发展

项目结构

civitai-mcp-server/
├── src/
│   ├── index.ts          # Main server implementation
│   ├── civitai-client.ts # Civitai API client
│   └── types.ts          # TypeScript type definitions
├── dist/                 # Compiled JavaScript output
├── tests/                # Test files
└── docs/                 # Additional documentation

从源头构建

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests
npm test

# Development mode with hot reload
npm run dev

测试

# Run comprehensive test suite
npm test

# Test specific endpoints
node test.js
node comprehensive-test.js

贡献

我们欢迎捐款！请查看我们的 贡献指南 了解详情。

开发设置

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 添加新功能的测试
5. 提交拉取请求

局限性

• 速率限制：Civitai API有费率限制。对于更高的限制，请使用API键。
• NSFW内容：某些内容可能会根据您的帐户设置进行筛选。
• 型号可用性：某些型号可能暂时不可用或需要身份验证。

故障排除

常见问题

服务器无法启动：

• 确保已安装Node.js 18+
• 检查是否安装了所有依赖项(npm install)
• 验证构建是否成功完成(npm run build)

API速率限制：

• 获取Civitai API密钥并设置 CIVITAI_API_KEY 环境变量
• 如果遇到限制，请降低请求频率

未找到型号：

• 检查型号ID的准确性
• 验证模型是否已被删除或设置为私有
• 确保搜索查询中的拼写正确

许可证

MIT许可证-有关详细信息，请参阅许可证文件

相关项目

• 模型上下文协议 -MCP规范
• 市民 -AI模型共享平台
• MCP服务器 -官方MCP服务器实施

支持

• 🐛 错误报告:
• 💡 功能请求:
• 📚 文档: Civitai API参考
• 🔧 MCP文件: 模型上下文协议