Star Wars Explorer -

An MCP server built with Laravel that provides access to Star Wars data via an external API and a local database.

php

0

GitHub Stars

php

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "joaoa1egre-mcp-app": {
      "command": "./vendor/bin/sail",
      "args": [
        "artisan",
        "mcp:start",
        "star-wars-explorer"
      ]
    }
  }
}

You can run Star Wars Explorer as a Model Context Protocol (MCP) server to query and manage Star Wars character data. It uses Laravel to expose local data and an external API, enabling fast local searches, character imports from SWAPI, and easy integration with MCP clients or AI assistants.

How to use

You interact with the Star Wars Explorer MCP server through an MCP client. Start the server in production mode to handle requests from your client, and optionally use the inspector to test tools and view responses in real time. Your client will send requests to the server to search for characters in your local database, or to import characters from the external API when needed.

How to install

Prerequisites: Install Docker and Docker Compose. Have Git available on your system.

Clone the project and navigate into the project directory.

git clone <url-do-repositorio>
cd mcp-app

Create a local environment configuration by copying the example file to the active environment file.

cp .env.example .env

Install PHP dependencies inside the container environment managed by Sail.

./vendor/bin/sail composer install

If you don’t have the Sail binary available, install dependencies with Composer first.

composer install

Generate the application key and run database migrations to prepare the environment.

./vendor/bin/sail artisan key:generate
./vendor/bin/sail artisan migrate

Start the containers to run the application in the background or watch logs in real time.

./vendor/bin/sail up -d
# or to view logs in real time
./vendor/bin/sail up

Additional setup notes

The server is designed to work with Laravel Sail, so you don’t need PHP installed locally. Everything runs inside Docker.

Available tools

StarWarsTool

Provides three modes of operation: list all characters, search by name, and import a character from the SWAPI by ID. It handles local database queries, imports from the external API when requested, and returns results to the MCP client.

GetProjectStats

Example tool that demonstrates supporting utility endpoints or statistics related to the project, included as a sample tool in the MCP setup.