MCP Starwars

@johnpapa

Basic information

About MCP Starwars

MCP Server for the SWAPI Star Wars API. The main goal of the project is to show how an MCP server can be used to interact with APIs.

#javascript #typescript #ai #mcp#starwars#starwars-api#mcp-server

MCP Starwars config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-starwars": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@johnpapa/mcp-starwars",
        "--client",
        "claude"
      ]
    }
  }
}

MCP Starwars tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Mcp Starwars?

Mcp Starwars is a Model Context Protocol (MCP) server that provides access to the SWAPI Star Wars API, allowing AI assistants to query characters, planets, films, species, vehicles, and starships. It is designed to demonstrate how an MCP server can interact with external APIs.

How to use Mcp Starwars?

Install via npx (npx -y @johnpapa/mcp-starwars) or Docker, then configure as an MCP tool in VS Code or Claude Desktop. For local testing, clone the repository and run the MCP Inspector.

Key features of Mcp Starwars

List and search Star Wars characters, planets, films, and more
Fetch detailed entity information by unique ID
Automatic pagination retrieves all results in one call
Built-in caching for optimized API performance
Cache management tools to clear or view cache statistics
Seamless integration with MCP-compatible hosts (VS Code, Copilot, Claude)

Use cases of Mcp Starwars

AI-powered Star Wars trivia and data exploration
Building interactive chatbot experiences with Star Wars lore
Educational demonstrations of MCP server capabilities
Rapid prototyping of agentic workflows using structured API data

Frequently asked questions

What data does Mcp Starwars use?

All data is fetched from the SWAPI documentation at [swapi.dev](https://swapi.dev).

What runtime does Mcp Starwars require?

Node.js version 20 or higher.

How do I install Mcp Starwars in VS Code?

Use the VS Code installation buttons in the README, or run `code --add-mcp` with the appropriate JSON configuration. You can also add it manually via VS Code settings or a `.vscode/mcp.json` file.

Can I run Mcp Starwars locally for testing?

Yes, clone the repository, install dependencies (`npm install`), build (`npm run build`), then start the MCP Inspector with `npx @modelcontextprotocol/inspector node build/index.js`.

Does Mcp Starwars require any authentication or API keys?

No, the SWAPI API is public and requires no authentication.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K