🔧 Features

🔧 Features

site icon
2025.04.16 0
TypeScript漫威API数据交互娱乐功能
Marvel MCP Server using Azure Functions 是一个基于Azure Functions的MCP服务器,用于与Marvel开发者API交互,获取漫威角色和漫画数据。该项目的主要目标是展示如何通过Azure Functions托管的MCP服务器与API进行交互。
View on GitHub

Overview

基本能力

产品定位

Marvel MCP Server using Azure Functions 是一个基于Azure Functions的MCP服务器,用于与Marvel开发者API交互,获取漫威角色和漫画数据。

核心功能

  • 列出漫威角色:支持多种过滤器,如nameStartsWithlimitcomicsseries等。
  • 通过ID获取漫威角色:使用characterId获取特定角色的详细信息。
  • 获取角色的漫画:获取特定角色出现的漫画列表,支持多种过滤器如formatdateRange等。
  • 基于工具的MCP集成:可以将此服务器注册到Model Context Protocol (MCP)工具(如VS Code、Claude等)。
  • 环境配置:使用.env文件管理环境变量,如MARVEL_PUBLIC_KEYMARVEL_PRIVATE_KEYMARVEL_API_BASE

适用场景

  • 开发者需要与漫威API交互获取角色和漫画数据。
  • 需要在MCP工具(如VS Code、Claude)中使用漫威数据的场景。

工具列表

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

常见问题解答

  • 数据来源:所有数据均来自官方Marvel API,该项目与Marvel无关。
  • 响应过滤:如果看到"Sorry, the response was filtered by the Responsible AI Service.",可以尝试重新运行或重新表述提示。

使用教程

使用依赖

  1. 需要安装Azure Storage Emulator,可以通过Docker或VS Code的Azurite扩展安装。

安装教程

  1. 克隆仓库: bash git clone https://github.com/DanWahlin/marvel-mcp-azure-functions
  2. 重命名.env.template.env并添加Marvel API的公钥和私钥。
  3. 安装依赖并构建项目: bash npm install npm run build
  4. 启动Azure Functions主机: bash npm start

调试方式

  1. 使用MCP Inspector调试: bash npx @modelcontextprotocol/inspector node build/index.js
  2. 访问MCP Inspector URL,更改Transport TypeSSE,输入URL并连接。

配置MCP主机

  1. 与Claude Desktop一起使用:在claude_desktop_config.json中添加MCP服务器配置。
  2. 与VS Code中的GitHub Copilot一起使用:在.vscode/mcp.json或VS Code用户设置中添加MCP服务器配置。

部署到Azure

  1. 使用azd up命令部署函数应用和相关Azure资源。
  2. 可选启用VNet或API Management以提高安全性。

许可证

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