mcp-starwars
5
The Star Wars MCP Server is designed to interact with the SWAPI API to access Star Wars universe data. It showcases features such as listing characters, planets, films, and other entities, providing detailed data retrieval with tools for caching and pagination.
Star Wars MCP Server
The project is an MCP Server utilizing the SWAPI (Star Wars API) to demonstrate interaction with APIs.
🔧 Features
- List Star Wars Characters: Retrieve character data with search filters and pagination
- List Planets, Films, Species, Vehicles, and Starships: Access entity collections with search
- Fetch Entity Details by ID: Get detailed information about specific entities
- Automatic Pagination: Retrieve all data pages with a single API call
- Built-in Caching: Optimize performance with API response caching
- Cache Management: Clear cache and view statistics
- Tool-based MCP Integration: Register server with MCP tools
🧰 Tools
- get_people: List characters
- get_person_by_id: Get details about a specific character
- get_planets: List planets
- get_planet_by_id: Get details about a specific planet
- get_films: List films
- get_film_by_id: Get details about a specific film
- get_species_list: List species
- get_species_by_id: Get details about a specific species
- get_vehicles: List vehicles
- get_vehicle_by_id: Get details about a specific vehicle
- get_starships: List starships
- get_starship_by_id: Get details about a specific starship
- clear_cache: Clear API cache
- get_cache_stats: Get API cache usage statistics
🛠️ Setup
Quick and Manual Installation in VS Code
- Follow commands or settings in VS Code to configure the server.
Installing via Smithery
- Use Smithery CLI to install server automatically.
Running Locally with MCP Inspector
- Clone repository, install dependencies, and run MCP Inspector.
Running the MCP Server hosted in GitHub Copilot with VS Code Insiders
- Configure VS Code or settings for MCP server discovery and tool usage.