🔧 Features

基本能力

产品定位

Marvel MCP Server 是一个用于与 Marvel Developer API 交互的 MCP 服务器，主要用于查询和获取 Marvel 角色和漫画的相关数据。

核心功能

• 列出 Marvel 角色：支持多种过滤器，如 nameStartsWith、limit、comics、series 等。
• 通过 ID 获取 Marvel 角色：使用 characterId 获取特定角色的详细信息。
• 获取角色的漫画列表：获取特定角色出现的漫画列表，支持多种过滤器如 format、dateRange 等。
• 基于工具的 MCP 集成：可以与 Model Context Protocol (MCP) 工具（如 VS Code、Claude 等）集成。
• 环境配置：使用 .env 文件管理环境变量，如 MARVEL_PUBLIC_KEY、MARVEL_PRIVATE_KEY 和 MARVEL_API_BASE。

适用场景

• 开发者需要查询 Marvel 角色和漫画数据的场景。
• 需要将 Marvel API 集成到 MCP 工具（如 VS Code、Claude 等）中的场景。
• 需要快速获取 Marvel 角色和漫画相关信息的场景。

工具列表

1. get_characters：获取 Marvel 角色列表，支持多种过滤器。
2. get_character_by_id：通过角色 ID 获取特定角色的详细信息。
3. get_comics_for_character：获取特定角色出现的漫画列表，支持多种过滤器。
4. get_comics：获取 Marvel 漫画列表，支持多种过滤器。
5. get_comic_by_id：通过漫画 ID 获取特定漫画的详细信息。
6. get_characters_for_comic：获取出现在特定漫画中的角色列表，支持多种过滤器。

常见问题解答

• 如何获取 Marvel API 密钥：需要注册 Marvel Developer API 账户并获取公钥和私钥。
• 如何配置环境变量：将 .env.template 重命名为 .env 并添加 Marvel API 密钥。
• 如何调试：可以使用 MCP Inspector 进行本地测试。

使用教程

使用依赖

1. 确保已安装 Node.js（版本 >= 20）。
2. 注册 Marvel Developer API 账户并获取 API 密钥。

安装教程

1. 克隆仓库： bash git clone https://github.com/DanWahlin/marvel-mcp-server
2. 重命名 .env.template 为 .env 并添加 API 密钥： bash MARVEL_PUBLIC_KEY=YOUR_PUBLIC_KEY MARVEL_PRIVATE_KEY=YOUR_PRIVATE_KEY MARVEL_API_BASE=https://gateway.marvel.com/v1/public
3. 安装依赖并构建项目： bash npm install npm run build

调试方式

1. 使用 MCP Inspector 进行本地测试： bash npx @modelcontextprotocol/inspector node build/index.js
2. 访问 MCP Inspector 提供的 URL 进行调试。

配置 MCP 主机

• 与 Claude Desktop 集成：在 claude_desktop_config.json 中添加 Marvel MCP Server 配置。
• 与 GitHub Copilot 集成：在 VS Code 的 mcp.json 或用户设置中添加 Marvel MCP Server 配置。

在 GitHub Copilot 中使用工具

1. 打开 GitHub Copilot 并选择 Agent 模式。
2. 刷新服务器列表并选择工具。
3. 输入相关问题，如： List 10 marvel characters. Include images.

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。