Star Wars

Star Wars

MCP server for SWAPI exposing Star Wars data via MCP tools with pagination and caching.

6
Stars
4
Forks
2
Releases

Overview

Star Wars MCP Server is an MCP server for the SWAPI Star Wars API. All data used by this MCP server is fetched from the SWAPI documentation. The main goal of the project is to demonstrate how an MCP server can be used to interact with APIs via MCP tools. The server exposes capabilities to list and detail Star Wars entities, including characters, planets, films, species, vehicles, and starships, with optional search and automatic pagination. It supports fetching a single entity by ID and can automatically paginate through results across endpoints. Built-in caching optimizes performance, with features to clear cache and view cache statistics. The server is designed to register with MCP tools such as VS Code and Claude, enabling tool-based workflows and discovery. Returned data includes typical attributes like names and physical characteristics, homeworlds, climates, model details, and related entities where applicable.

Details

Owner
johnpapa
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

List Star Wars Characters

List Star Wars characters with optional search filters and automatic pagination.

List Planets, Films, Species, Vehicles, and Starships

Access all Star Wars entity collections with search capabilities.

Fetch Entity Details by ID

Get detailed information about a specific character, planet, film, species, vehicle, or starship by ID.

Automatic Pagination

Seamlessly retrieve all pages of data with a single API call.

Built-in Caching

Optimize performance with intelligent API response caching.

Cache Management

Clear cache and view cache statistics to monitor performance.

Tool-based MCP Integration

Register this server with MCP tools (VS Code, Claude, and others) for discovery and invocation.

Audience

DevelopersUse MCP tools such as VS Code and Claude to query Star Wars data programmatically.
Tooling IntegratorsRegister and test MCP servers with various tools for discovery and invocation.
Product TeamsExplore API data via MCP-enabled workflow automation and caching features.

Tags

Star WarsSWAPIMCPAPIPaginationCachingTools integration