Star Wars MCP Server Integration

What does “Star Wars” MCP Server do?

The Star Wars MCP Server is a Model Context Protocol (MCP) server designed to interact with the SWAPI Star Wars API. Its primary purpose is to demonstrate how an MCP server can serve as a bridge between AI assistants and external APIs, enabling enhanced development workflows. By connecting to the SWAPI, the server empowers AI clients to query and retrieve data about the Star Wars universe, such as characters, planets, starships, and more. This capability allows AI tools to provide richer user experiences, automate information retrieval, and streamline tasks related to Star Wars data, all while showcasing the power of MCP in integrating third-party APIs into LLM-powered workflows.

List of Prompts

No information about prompt templates was found in the repository.

List of Resources

No explicit list of Model Context Protocol resources was found in the repository.

List of Tools

No explicit tool definitions (e.g., query_database, call_api) were found in the repository. The repository is described as an MCP server for interacting with the SWAPI, but specific tool interfaces are not documented in the visible files.

Use Cases of this MCP Server

• API Integration for Star Wars Data
  Developers can use the server as a bridge to the SWAPI, enabling AI agents to fetch detailed Star Wars universe information for apps, chatbots, or educational tools.

• Automated Trivia Generation
  By leveraging the MCP server, trivia games and quizzes can automatically generate questions and answers using live Star Wars data from the API.

• Knowledge Base Augmentation
  Enhance AI knowledge bases with up-to-date information about characters, planets, and vehicles from the Star Wars universe.

• Code Sample Demonstrations
  The server acts as a reference implementation of how to build MCP servers that connect to REST APIs, aiding developers in learning MCP concepts.

How to set it up

Windsurf

1. Ensure Node.js is installed on your system.
2. Locate your Windsurf configuration file.
3. Add the Star Wars MCP Server using the following JSON snippet:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Save the configuration and restart Windsurf.
5. Verify the server is running by checking the Windsurf logs.

Claude

1. Install Node.js if not already present.
2. Open the Claude integration configuration.
3. Insert the following under MCP servers:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Save and reload Claude.
5. Confirm the server is active via the Claude interface.

Cursor

1. Make sure Node.js is set up.
2. Access the Cursor configuration file.
3. Add the Star Wars MCP Server entry:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Restart Cursor to apply changes.
5. Validate that the MCP server is accessible.

Cline

1. Set up Node.js on your environment.
2. Open the Cline settings for MCP servers.
3. Register the Star Wars MCP Server:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Save the configuration and restart Cline.
5. Check Cline’s status page for server connection.

Securing API Keys

If the server or SWAPI requires an API key or environment variable, use the following format:

{
  "mcpServers": {
    "starwars-mcp": {
      "command": "npx",
      "args": ["@johnpapa/mcp-starwars@latest"],
      "env": {
        "SWAPI_API_KEY": "${SWAPI_API_KEY}"
      },
      "inputs": {
        "apiKey": "${SWAPI_API_KEY}"
      }
    }
  }
}

Note: The SWAPI API is public and typically does not require an API key, but this template is provided for best practices.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "starwars-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “starwars-mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Our opinion

The Star Wars MCP Server is a reference implementation focusing on connecting AI agents to the Star Wars API via MCP. While it demonstrates the concept well, it lacks documentation for resources, prompt templates, and tools, which are important for production use. As an educational sample, it is clear and MIT-licensed, but its utility is limited by the absence of advanced MCP features.

MCP Score

Overall, this MCP server would be rated 4/10, as it is a solid starting point but lacks the depth and documentation of a fully-featured MCP integration.