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：获取特定故事情节的详细信息
搜索工具
search：跨所有Comic Vine内容类型的统一搜索
每个工具支持：
- 选择字段以自定义响应内容
- 大型结果集的分页
- 排序选项
- 按各种标准筛选
- 丰富的图像标记格式
- 显示资源之间的关系
设置
先决条件
- Node.js 16或更高版本
- npm或纱线
- Comic Vine API密钥
获取Comic Vine API密钥
- 访问 漫画藤
- 如果您没有帐户，请注册一个帐户
- 转到您的帐户设置
- 请求API密钥
- 复制API密钥
安装
- 克隆存储库：
git clone https://github.com/urlyss/comic-database-mcp.gitcd comic-database-mcp- 安装依赖项：
npm install- 构建项目：
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语法正确格式化图像
- 不同类型信息的结构化部分
- 相关资源链接
- 列表和详细信息的干净格式
故障排除
常见问题
- API关键问题
Error: Invalid API Key- 验证您的Comic Vine API密钥是否正确
- 检查API密钥是否在身份验证头中正确设置
- 对于stdio传输，请确保在启动进程时在环境变量中传递API密钥
- 连接问题
Error: ECONNREFUSED- 对于HTTP传输：验证服务器是否正在运行，端口（80）是否未被使用
- 对于stdio传输：确保MCP检查器中的进程路径指向正确的文件
- 格式问题
Error: Invalid format specified- 检查您的请求是否包含正确的字段名
- 验证字段值是否与预期类型匹配
- 对于图像字段，请确保正确处理URL格式
- 速率限制
Error: Too Many Requests- Comic Vine API有价格限制
- 在应用程序中实现请求缓存
- 在测试场景中增加请求之间的延迟
获取帮助
在GitHub上提交问题：
- 传输类型（HTTP或stdio）
- 重现步骤
- 预期行为与实际行为
