AI导哈

漫画数据查询服务

一个提供对Comic Vine API结构化访问的MCP服务器，使AI助手能够以对话形式轻松查询和检索漫画书籍信息。

  • by Urlyss
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Urlyss/comic-database-mcp

使用说明

Comic Vine MCP服务器

一种模型上下文协议（MCP）服务器，提供对Comic Vine API的结构化访问，允许人工智能助手以对话格式轻松查询和检索漫画信息。

特性

  • 丰富的markdown格式响应，便于阅读和显示
  • Comic Vine资源的全面覆盖：
    • 角色
    • 问题
    • 卷/系列
    • 出版商
    • 故事方舟
  • 跨所有内容类型的统一搜索
  • 包含图像和关系的详细信息
  • 支持过滤、分页和排序
  • 带Zod模式验证的类型安全API

可用工具

角色工具

  • get-characters：列出带有过滤和分页功能的漫画书角色

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

    查看角色工具文档

问题工具

  • get-issues：使用过滤和分页列出漫画书问题

  • get-issue：获取有关特定问题的详细信息

    查看问题工具文档

卷工具

  • get-volumes：列出漫画书卷/系列，并进行过滤和分页

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

    查看卷工具文档

出版商工具

  • get-publishers：列出具有过滤和分页功能的漫画出版商

  • get-publisher：获取特定发布者的详细信息

    查看发布者工具文档

故事弧工具

  • get-story-arcs：列出带有过滤和分页功能的漫画故事情节

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

    查看故事Arc Tools文档

搜索工具

每个工具支持：

  • 选择字段以自定义响应内容
  • 大型结果集的分页
  • 排序选项
  • 按各种标准筛选
  • 丰富的图像标记格式
  • 显示资源之间的关系

设置

先决条件

  • Node.js 16或更高版本
  • npm或纱线
  • Comic Vine API密钥

获取Comic Vine API密钥

  1. 访问 漫画藤
  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检查器：

# Start the MCP Inspector
npx @modelcontextprotocol/inspector
  • 访问浏览器控制台中显示的MCP检查器URL
  • 改变 Transport Type 向 Streamable HTTP
  • 更改 URL 向 http://localhost/mcp （或您用来运行服务器的任何url）
  • 在 Authentication 部分中输入您的API密钥 Bearer Token
  • 选择 Connect。选择 List Tools 查看可用工具

使用stdio传输进行测试

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

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

您可以使用MCP检查器测试stdio传输：

# Start the MCP Inspector
npx @modelcontextprotocol/inspector
  • 访问控制台中显示的MCP检查器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检查器中的进程路径指向正确的文件
  1. 格式问题
Error: Invalid format specified
  • 检查您的请求是否包含正确的字段名
  • 验证字段值是否与预期类型匹配
  • 对于图像字段，请确保正确处理URL格式
  1. 速率限制
Error: Too Many Requests
  • Comic Vine API有价格限制
  • 在应用程序中实现请求缓存
  • 在测试场景中增加请求之间的延迟

获取帮助

在GitHub上提交问题：

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

相关 MCP