mcpField
C
Comic Vine MCP Server

Comic Vine MCP Server

本地服务
github.com/Urlyss数据库173 周前更新
代码仓库

关于 Comic Vine MCP Server

Comic Vine MCP Server 将 Comic Vine API 的漫画资料以结构化形式提供给 AI 助手，适合查询漫画角色、单期、系列、出版社和故事线。它支持跨类型搜索、筛选和分页，并以含图片及关联信息的 Markdown 返回结果。

主要功能

  1. 01查询角色、单期、系列、出版社和故事线
  2. 02跨内容类型统一搜索
  3. 03筛选、排序与分页
  4. 04选择返回字段
  5. 05Markdown 格式呈现图片及资源关联

适用场景

  1. 01查找漫画角色及其相关资料
  2. 02浏览某系列的单期和出版社信息
  3. 03搜索故事线并查看关联资源

MCP 相关

该 MCP 服务将 Comic Vine API 的查询能力暴露给 MCP 客户端，涵盖角色、单期、系列、出版社、故事线和统一搜索工具。

#comic-database#comic-vine#api-assistant

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "comic-database": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Comic Vine MCP 服务

一个模型上下文协议（MCP）服务，可结构化访问 Comic Vine API，让 AI 助手能够以对话形式轻松查询和获取漫画信息。

功能

  • 内容丰富、采用 Markdown 格式的响应，便于阅读和显示
  • 全面覆盖 Comic Vine 资源：
    • 角色
    • 单期漫画
    • 合集／系列
    • 出版商
    • 故事线
  • 支持跨所有内容类型的统一搜索
  • 提供包含图片和关联关系的详细信息
  • 支持筛选、分页和排序
  • 通过 Zod 架构验证提供类型安全的 API

可用工具

角色工具

  • get-characters：列出漫画角色，支持筛选和分页

  • get-character：获取特定角色的详细信息

    查看角色工具文档

单期漫画工具
合集工具

  • get-volumes：列出漫画合集／系列，支持筛选和分页

  • get-volume：获取特定合集的详细信息

    查看合集工具文档

出版商工具

  • get-publishers：列出漫画出版商，支持筛选和分页

  • get-publisher：获取特定出版商的详细信息

    查看出版商工具文档

故事线工具

  • get-story-arcs：列出漫画故事线，支持筛选和分页

  • get-story-arc：获取特定故事线的详细信息

    查看故事线工具文档

搜索工具

每个工具均支持：

  • 选择字段，自定义响应内容
  • 为大型结果集提供分页
  • 排序选项
  • 按各种条件筛选
  • 包含图片的丰富 Markdown 格式
  • 显示资源之间的关联关系

设置

先决条件
  • Node.js 16 或更高版本
  • npm 或 yarn
  • Comic Vine API 密钥
获取 Comic Vine API 密钥
  1. 访问 Comic Vine
  2. 如果尚未注册，请创建一个账户
  3. 前往账户设置
  4. 申请 API 密钥
  5. 复制 API 密钥
安装
  1. 克隆代码库：
git clone https://github.com/urlyss/comic-database-mcp.git

cd comic-database-mcp
  1. 安装依赖：
npm install
  1. 构建项目：
npm run build
通过 HTTP 传输运行服务

开发模式（热重载）：

npm run dev

生产模式：

npm start
通过 STDIO 传输运行服务

开发模式（热重载）：

npm run stdio-dev

生产模式：

npm stdio-start
使用 HTTP 传输进行测试

构建并运行服务后，即可对其进行测试。

使用 MCP Inspector：

# Start the MCP Inspector
npx @modelcontextprotocol/inspector
  • 在浏览器中访问控制台显示的 MCP Inspector URL
  • 将 Transport Type 更改为 Streamable HTTP
  • 将 URL 更改为 http://localhost/mcp（或你用于运行服务的 URL）
  • 在 Authentication 部分的 Bearer Token 中输入 API 密钥
  • 选择 Connect，再选择 List Tools 查看可用工具
使用 stdio 传输进行测试

构建并运行服务后，即可对其进行测试。

该服务支持 stdio 传输，可直接与 AI 助手集成：

你可以使用 MCP Inspector 测试 stdio 传输：

# Start the MCP Inspector
npx @modelcontextprotocol/inspector
  • 访问控制台中显示的 MCP Inspector URL
  • 将 Transport Type 更改为 stdio
  • 在 Process Path 字段中输入：node path/to/the/server/dist/api/stdio-index.js
  • 在 Environment Variables 部分添加：
    • 名称：COMIC_VINE_API_KEY
    • 值：你的 Comic Vine API 密钥
  • 选择 Connect。
  • 选择 List Tools，查看可用工具

stdio 传输尤其适用于：

  • 直接与 AI 助手集成
  • 自动化测试和脚本
  • 不适合使用 HTTP 传输的环境

响应格式

所有响应均采用 Markdown 格式，便于阅读，包括：

  • 用于精确引用的资源 ID
  • 使用 Markdown 语法正确排版的图片
  • 按不同信息类型组织的结构化部分
  • 指向相关资源的链接
  • 清晰排版的列表和详情
故障排除
常见问题
  1. API 密钥问题
Error: Invalid API Key
  • 确认 Comic Vine API 密钥正确
  • 检查是否已在身份验证标头中正确设置 API 密钥
  • 对于 stdio 传输，确保启动进程时已通过环境变量传入 API 密钥
  1. 连接问题
Error: ECONNREFUSED
  • 对于 HTTP 传输：确认服务正在运行，且端口 (80) 未被占用
  • 对于 stdio 传输：确保 MCP Inspector 中的进程路径指向正确的文件
  1. 格式问题
Error: Invalid format specified
  • 检查请求是否包含正确的字段名称
  • 确认字段值符合预期类型
  • 对于图片字段，确保正确处理 URL 格式
  1. 速率限制
Error: Too Many Requests
  • Comic Vine API 有速率限制
  • 在应用程序中实现请求缓存
  • 在测试场景中于请求之间增加延迟
获取帮助

在 GitHub 上提交 issue，并提供：

  • 传输类型（HTTP 或 stdio）
  • 重现步骤
  • 预期行为与实际行为

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。