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文档

搜索工具

• search：跨所有Comic Vine内容类型的统一搜索

查看搜索工具文档

每个工具支持：

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

设置

先决条件

• 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）
• 重现步骤
• 预期行为与实际行为