Comics MCP (🦸🦹)

A Model Context Protocol (MCP) server with plugin architecture for comic-related data sources.

Requirements: Python 3.11+

🚀 Quick Start

# 1. Install
pip install -e .

# 2. Create .env file with your API key
echo "COMICVINE_API_KEY=your-api-key" > .env

# 3. Run server
python3 -m comics_mcp.mcp_server

Related MCP server: MCP Boilerplate

🧩 Available Plugins

🔧 Setup

1. Get Comic Vine API Key:

   • Register at Comic Vine

   • Request an API key

2. Install and Configure:

   git clone https://github.com/imikailoby/comics-mcp.git
   cd comics-mcp
   pip install -e .
   echo "COMICVINE_API_KEY=your-api-key" > .env

3. Configure MCP Client:

   {
     "mcpServers": {
       "comics-mcp": {
         "command": "python3",
         "args": ["-m", "comics_mcp.mcp_server"],
         "env": {
           "PYTHONPATH": "/path/to/your/comics-mcp",
           "COMICVINE_API_KEY": "your_api_key"
         }
       }
     }
   }

📊 Character Data Fields

The comicvine plugin returns comprehensive character information including:

• Basic Info: name, real_name, description, publisher

• Media: image_url, source_url

• Details: aliases, origin, birth date, count_of_issue_appearances

• Legal: legal_note with data source attribution

🤝 Contributing

Contributions are welcome! Feel free to help with:

• Adding new data sources (Marvel API, DC API, etc.)

• Adding new plugins or tools to existing plugins

• Improving plugin interfaces or descriptions

• Writing documentation or test coverage

• Performance optimizations

⚡ Powered by

• Comic Vine. Not affiliated with or endorsed by Comic Vine.