Mcp Starwars

Name: Mcp Starwars
Author: johnpapa

@johnpapa

关于 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

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

johnpapa

提交者

John Papa

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

FAQ from Mcp Starwars

What data does Mcp Starwars use?

All data is fetched from the SWAPI documentation at 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.