Marvel MCP

🚀 《Marvel MCP Server 配置指南》 中文版

本指南將詳細介紹如何安裝、配置和使用 Marvel MCP Server，幫助你輕鬆接入 Marvel API 進行相關開發。

🚀 快速開始

📦 安裝與運行 Marvel MCP Server

使用 npm 運行

在終端中執行以下命令進行安裝和構建：

npm install
npm run build

完成後，啟動服務：

npx @modelcontextprotocol/inspector node build/index.js

打開瀏覽器訪問控制檯顯示的 MCP 檢查工具鏈接。

直接運行構建文件（可選）

如果你已經完成了構建步驟，可以直接運行：

npm run build

✨ 主要特性

本項目提供了便捷的方式來配置和使用 Marvel MCP Server，支持在不同的開發環境（如 Claude Desktop、VS Code）中進行配置，並且可以在 GitHub Copilot 中使用相關工具來查詢 Marvel 角色和漫畫信息。

📦 安裝指南

配置 MCP 服務器

在 Claude Desktop 中配置

在 claude_desktop_config.json 文件中添加以下內容：

{
  "mcpServers": {
    "marvel-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codewithdan/marvel-mcp"
      ],
      "env": {
        "MARVEL_PUBLIC_KEY": "YOUR_PUBLIC_KEY",
        "MARVEL_PRIVATE_KEY": "YOUR_PRIVATE_KEY", 
        "MARVEL_API_BASE": "https://gateway.marvel.com/v1/public"
      }
    }
  }
}

在 VS Code 中配置（針對 GitHub Copilot）

在 .vscode/mcp.json 文件中添加以下內容：

{
  "inputs": [],
  "servers": {
    "marvel-mcp": {
      "command": "npx",
      "args": [
        "-y", 
        "@codewithdan/marvel-mcp"
      ],
      "env": {
        "MARVEL_PUBLIC_KEY": "YOUR_PUBLIC_KEY",
        "MARVEL_PRIVATE_KEY": "YOUR_PRIVATE_KEY",
        "MARVEL_API_BASE": "https://gateway.marvel.com/v1/public"
      }
    }
  }
}

或者在用戶設置中添加：

"mcp": {
  "servers": {
    "marvel-mcp": {
      "command": "npx",
      "args": [
        "-y", 
        "@codewithdan/marvel-mcp"
      ],
      "env": {
        "MARVEL_PUBLIC_KEY": "YOUR_PUBLIC_KEY", 
        "MARVEL_PRIVATE_KEY": "YOUR_PRIVATE_KEY",
        "MARVEL_API_BASE": "https://gateway.marvel.com/v1/public"
      }
    },
  }
}

安裝工具（可選）

使用 Smithery CLI 安裝：

npx -y @smithery/cli install @DanWahlin/marvel-mcp --client Claude

💻 使用示例

在 GitHub Copilot 中使用

1. 打開 VS Code 的 Insider 版本。
2. 啟用 Agent 模式（而非 Ask 或 Edits）。
3. 點擊輸入框右側的刷新按鈕更新可用工具列表。
4. 輸入問題，例如：

列出 10 個 Marvel 角色。

Wolverine 出現在哪些漫畫中？

給我一些反派角色的信息。

哪些角色出現在復仇者聯盟漫畫裡？

Hedge Knight II: Sworn Sword (2007) 這本漫畫有哪些人物？

列出蟻人漫畫中的 10 個角色。

注意事項

⚠️ 重要提示

如果出現 "響應被 Responsible AI Service 過濾" 的提示，請重新提問或調整措辭。

🔧 技術細節

環境變量配置

請將以下信息替換為你的 Marvel API 密鑰：

• MARVEL_PUBLIC_KEY：公開訪問密鑰。
• MARVEL_PRIVATE_KEY：私有訪問密鑰。 這些密鑰可從 Marvel API 官網 獲取。