mcpField
S
swapi-mcp

swapi-mcp

Local
github.com/abhishekjkrsnaGames & Entertainment0Updated 13w ago
Repository

About swapi-mcp

swapi-mcp is a TypeScript MCP server for accessing selected Star Wars API (SWAPI) data from MCP-compatible clients. It provides tools to list available data categories and retrieve character information.

Key features

  1. 01Fetch selected data from SWAPI
  2. 02List available Star Wars categories
  3. 03Retrieve character information
  4. 04Validate tool schemas with Zod

Use cases

  1. 01Look up Star Wars character details
  2. 02Check which SWAPI categories are available

MCP support

The server exposes SWAPI data through MCP tools over stdio for use by compatible clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "abhishekjkrsna-swapi": {
      "command": "npx",
      "args": [
        "-y",
        "@abhishekjkrsna/swapi-mcp"
      ]
    }
  }
}
Run commandnpx -y @abhishekjkrsna/swapi-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@abhishekjkrsna/swapi-mcp1.0.4

Tools

3

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

SWAPI MCP

A TypeScript-based Model Context Protocol (MCP) server that exposes Star Wars API data as MCP tools.

This project connects to the Star Wars API (SWAPI) and makes selected Star Wars information available through MCP-compatible clients using stdio transport.

Features

  • MCP server built with TypeScript
  • stdio-based MCP transport
  • Fetches Star Wars data from SWAPI
  • Tool schema validation with Zod
  • Includes Vitest test setup
  • Supports coverage reports

Tech Stack

  • TypeScript
  • Node.js
  • Model Context Protocol SDK
  • Zod
  • Vitest
  • tsx

Project Structure

text swapi-mcp/ ├── src/ # Source code ├── tests/ # Test files and mock data │ ├── api/ │ └── mock_data/ ├── package.json ├── package-lock.json ├── tsconfig.json └── vitest.config.js

Requirements

  • Node.js 20 or newer
  • npm

Some MCP-related dependencies require Node.js 20+, so using the latest LTS version is recommended.

Installation

npm install

Clone the repository and install dependencies:

Available Scripts

Start the development server

npm run start

Runs the MCP server directly from TypeScript using tsx.

Build the project

npm run build

Compiles TypeScript into JavaScript using the TypeScript compiler.

Run tests

npm run test

When started, the server connects using stdio and can be used by MCP-compatible clients.

Available Tools

get-list-of-star-wars-information

Returns a comma-separated list of available Star Wars information categories from SWAPI, such as:

  • people
  • planets
  • films
  • species
  • vehicles
  • starships
get-information-of-star-wars-characters

Returns Star Wars character information exposed by the project’s character tool.

Example MCP Client Configuration

You can configure an MCP-compatible client to run this server with npm:

{ "mcpServers": { "swapi-mcp": { "command": "npm", "args": ["start"] } } }

If your client requires an absolute working directory, configure it like this:

{ "mcpServers": { "swapi-mcp": { "command": "npm", "args": ["start"], "cwd": "/absolute/path/to/swapi-mcp" } } }

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.