漫威MCP服务器
备注：Marvel最近退役了他们的API，所以很遗憾它不再可用。由于这种方法仍然适用于MCP服务器，因此我将出于历史目的保留此仓库。如果你想看到一个类似的例子，看看我的 DC漫画MCP服务器.
MCP服务器 漫威开发者API，实现与角色和漫画数据的交互。 *该项目的主要目标是展示如何使用MCP服务器与API进行交互。*
备注：此MCP服务器使用的所有数据都是从 官方Marvel API 并归漫威所有。该项目与漫威没有任何关联。
🔧 特性
- 列出漫威角色：支持以下过滤器
nameStartsWith,limit,comics,series等等。 - 按ID获取漫威角色：使用他们的工具获取任何角色的详细信息
characterId. - 为角色获取漫画：获取具有特定角色的漫画列表，并使用各种过滤器，如
format,dateRange等等。 - 丰富内容显示：当您询问角色或漫画时，服务器将：
- 显示有关角色和漫画的详细信息，包括图像、名称、描述等。 - 创建HTML页面(marvel-content.html)里面有所有的内容。 - 尝试在默认浏览器中打开新创建的HTML页面，以获得更好的查看体验。
- 基于工具的MCP集成：使用模型上下文协议（MCP）工具（VS Code、Claude等）注册此服务器。
- 环境配置：使用
.env用于管理环境变量的文件，如MARVEL_PUBLIC_KEY,MARVEL_PRIVATE_KEY和MARVEL_API_BASE.
🧰 工具
1. get_characters 🔍🦸♂️
- 描述：使用可选过滤器获取漫威角色。
- 输入:
- name （可选字符串）：完整字符名称。 - nameStartsWith （可选字符串）：名称以指定字符串开头的字符。 - modifiedSince （可选字符串）：ISO 8601日期字符串，用于过滤自该日期以来修改的字符。 - comics, series, events, stories （可选字符串）：以逗号分隔的ID列表，按相关实体进行筛选。 - orderBy （可选字符串）：用于对结果进行排序的字段，例如 name 或 -modified. - limit （可选数字）：返回的最大结果数（1-100）。 - offset （可选数字）：分页时要跳过的结果数。
- 退货：具有匹配字符的JSON响应。看
CharacterDataWrapperSchema在src/schemas.ts了解详情。
2. get_character_by_id 🆔🧑🎤
- 描述：通过漫威角色的唯一ID获取该角色。
- 输入:
- characterId （number）：字符的唯一ID。
- 退货：包含字符详细信息的JSON响应。看
CharacterDataWrapperSchema在src/schemas.ts了解详情。
3. get_comics_for_character 📚🎭
- 描述：使用可选过滤器获取具有特定角色的漫画。
- 输入:
- characterId （number）：字符的唯一ID。 - 可选过滤器： - format, formatType （string）：按漫画格式过滤（例如。， comic, hardcover). - noVariants, hasDigitalIssue （boolean）：用于排除变体或仅包含数字问题的标志。 - dateDescriptor （string）：预定义的日期范围，如 thisWeek, nextWeek. - dateRange （string）：格式为自定义日期范围 YYYY-MM-DD,YYYY-MM-DD. - title, titleStartsWith （string）：按标题或标题前缀过滤。 - startYear, issueNumber, digitalId （数字）：数字过滤器。 - diamondCode, upc, isbn, ean, issn （string）：标识符筛选器。 - creators, series, events, stories, sharedAppearances, collaborators （string）：以逗号分隔的相关实体ID列表。 - orderBy （string）：用于对结果进行排序的字段，例如 title 或 -modified. - limit, offset （数字）：分页选项。
- 退货：JSON响应，带有指定字符的漫画。看
ComicDataWrapperSchema在src/schemas.ts了解详情。
4. get_comics 📖🕵️♂️
- 描述：使用可选过滤器获取漫威漫画列表。
- 输入:
- format （可选字符串）：按问题格式过滤（例如。， comic, digital comic, hardcover). - formatType （可选字符串）：按问题格式类型筛选(comic 或 collection). - noVariants （可选布尔值）：从结果集中排除变体（备用封面、二次打印、导演剪辑等）。 - dateDescriptor （可选字符串）：返回预定义日期范围内的漫画(lastWeek, thisWeek, nextWeek, thisMonth). - dateRange （可选字符串）：返回自定义日期范围内的漫画。日期必须指定为 YYYY-MM-DD,YYYY-MM-DD. - title （可选字符串）：仅返回标题与输入匹配的系列问题。 - titleStartsWith （可选字符串）：仅返回标题以输入开头的系列中的问题。 - startYear （可选数字）：仅返回开始年份与输入匹配的系列问题。 - issueNumber （可选编号）：仅返回序列号与输入匹配的问题。 - diamondCode, digitalId, upc, isbn, ean, issn （可选字符串）：按各种标识符过滤。 - hasDigitalIssue （可选布尔值）：仅包括数字结果。 - modifiedSince （可选字符串）：仅返回自指定日期以来修改过的漫画（ISO 8601格式）。 - creators, characters, series, events, stories, sharedAppearances, collaborators （可选字符串）：以逗号分隔的ID列表，按相关实体进行筛选。 - orderBy （可选字符串）：按一个或多个字段对结果集进行排序。在值中添加“-”以按降序排序（例如。， title, -modified). - limit （可选数字）：将结果集限制为指定数量的资源（默认值：20，最大值：100）。 - offset （可选数字）：跳过结果集中指定数量的资源。
- 退货：带有匹配漫画的JSON响应。看
ComicDataWrapperSchema在src/schemas.ts了解详情。
5. get_comic_by_id 🆔📘
- 描述：通过其唯一ID获取一部漫威漫画。
- 输入:
- comicId （数字）：漫画的唯一ID。
- 退货：带有漫画细节的JSON响应。看
ComicDataWrapperSchema在src/schemas.ts了解详情。
6. get_characters_for_comic 🦸♀️📖
- 描述：获取出现在特定漫画中的漫威角色。
- 输入:
- comicId （数字）：漫画的唯一ID。 - 可选过滤器： - name （可选字符串）：按全名过滤字符。 - nameStartsWith （可选字符串）：筛选名称以指定字符串开头的字符。 - modifiedSince （可选字符串）：ISO 8601日期字符串，用于过滤自该日期以来修改的字符。 - series, events, stories （可选字符串）：以逗号分隔的相关实体ID列表。 - orderBy （可选字符串）：用于对结果进行排序的字段，例如 name 或 -modified. - limit （可选数字）：返回的最大结果数（1-100）。 - offset （可选数字）：分页时要跳过的结果数。
- 退货：JSON响应，其中字符出现在指定的漫画中。看
CharacterDataWrapperSchema在src/schemas.ts了解详情。
🛠️ 设置
注册一个 漫威开发者API 帐户并获取您的公共和私人API密钥。
如果您想直接在MCP主机中运行它，请跳到 与Claude Desktop一起使用 或 部分。
使用MCP检查器在本地运行服务器
如果您想在本地运行MCP Inspector来测试服务器，请执行以下步骤：
- 克隆此存储库：
git clone https://github.com/DanWahlin/marvel-mcp- 重命名
.env.template到.env.
- 将您的Marvel API公钥和私钥添加到
.env文件。
MARVEL_PUBLIC_KEY=YOUR_PUBLIC_KEY
MARVEL_PRIVATE_KEY=YOUR_PRIVATE_KEY
MARVEL_API_BASE=https://gateway.marvel.com/v1/public- 安装所需的依赖项并构建项目。
npm install
npm run build- （可选）要使用MCP Inspector试用服务器，请运行以下命令：
# Start the MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js访问浏览器控制台中显示的MCP检查器URL。改变 Arguments 到 dist/index.js 并选择 Connect。选择 List Tools 查看可用工具。
配置MCP主机
与Claude Desktop一起使用
将以下内容添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"marvel-mcp": {
"type": "stdio",
"command": "npx",
// "command": "node",
"args": [
"-y",
"@codewithdan/marvel-mcp"
// "/PATH/TO/marvel-mcp/dist/index.js"
],
"env": {
"MARVEL_PUBLIC_KEY": "YOUR_PUBLIC_KEY",
"MARVEL_PRIVATE_KEY": "YOUR_PRIVATE_KEY",
"MARVEL_API_BASE": "https://gateway.marvel.com/v1/public"
}
}
}
}通过Smithery安装
通过以下方式自动安装Marvel MCP Server for Claude Desktop 史密瑟里:
npx -y @smithery/cli install @DanWahlin/marvel-mcp --client claude与GitHub Copilot一起使用
备注：如果您已经使用Claude Desktop启用了MCP服务器，请添加 chat.mcp.discovery.enabled: true 在您的VS代码设置中，它将发现现有的MCP服务器列表。将以下内容添加到您的用户设置文件或将其添加到 .vscode/mcp.json 如果你只想在这个仓库中使用它，可以使用MCP:从命令面板中添加服务器，然后选择全局或工作区：
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "marvel-public-api-key",
"description": "Marvel public API Key",
"password": true
},
{
"type": "promptString",
"id": "marvel-private-api-key",
"description": "Marvel private API Key",
"password": true
}
],
"servers": {
"marvel-mcp": {
"command": "npx",
// "command": "node",
"args": [
"-y",
"@codewithdan/marvel-mcp"
// "/PATH/TO/marvel-mcp/dist/index.js"
],
"env": {
"MARVEL_PUBLIC_KEY": "${input:marvel-public-api-key}",
"MARVEL_PRIVATE_KEY": "${input:marvel-private-api-key}",
"MARVEL_API_BASE": "https://gateway.marvel.com/v1/public"
}
}
}
}在GitHub Copilot中使用工具
- 现在可以发现mcp服务器，打开GitHub Copilot并选择
Agent模式（非Ask或Edits).
- 在副驾驶聊天文本字段中选择“刷新”按钮以刷新服务器列表。
- 选择“🛠️“按钮查看所有可能的工具，包括此仓库中的工具。
- 在聊天中提出一个问题，自然会调用其中一个工具，例如：
List 10 marvel characters.
What comics is Wolverine in?
Give me details about villains in the Marvel universe.
Which characters appear in the Avengers comics?
What characters are in the Hedge Knight II: Sworn Sword (2007) comic?
List 10 characters from Ant-Man comics.> 备注：如果您看到“对不起，响应已由负责任的人工智能服务过滤。”，请尝试再次运行或重新表述提示。
- 奖金：当你询问角色或漫画时，服务器会自动创建一个
marvel-content.html在项目根目录中创建一个文件，其中包含一个风格优美的页面，其中包含所有角色/漫画信息和图像，然后在浏览器中打开它！