Claude Code

\n\n```bash\nclaude mcp add --transport http swapi-build https://swapi.build/mcp\n```\n\nOr share via `.mcp.json` at the repo root:\n\n```json\n{\n \"mcpServers\": {\n \"swapi-build\": { \"type\": \"http\", \"url\": \"https://swapi.build/mcp\" }\n }\n}\n```\n\nVerify: `claude mcp list` → `swapi-build ✔ Connected`.\n

\n\n

Claude Desktop & claude.ai

\n\nSettings → Connectors → **Add custom connector** → name `swapi-build`, URL\n`https://swapi.build/mcp`. No authentication needed. Verify in any chat via the **+** menu → Connectors.\n

\n\n

OpenAI Codex

\n\n```bash\ncodex mcp add swapi-build --url https://swapi.build/mcp\n```\n\nOr in `~/.codex/config.toml` (shared by CLI, IDE extension and ChatGPT desktop):\n\n```toml\n[mcp_servers.swapi-build]\nurl = \"https://swapi.build/mcp\"\n```\n\nVerify: `codex mcp list`.\n

\n\n

GitHub Copilot (VS Code)

\n\n`.vscode/mcp.json` (top-level key is `servers`):\n\n```json\n{\n \"servers\": {\n \"swapi-build\": { \"type\": \"http\", \"url\": \"https://swapi.build/mcp\" }\n }\n}\n```\n\nOr Command Palette → **MCP: Add Server**. Verify via the **Configure Tools** button in Copilot Chat.\nOn Business/Enterprise, the \"MCP servers in Copilot\" org policy must be enabled.\n

\n\n

IBM Bob

\n\n`~/.bob/settings/mcp_settings.json` (global) or `.bob/mcp.json` (project):\n\n```json\n{\n \"mcpServers\": {\n \"swapi-build\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://swapi.build/mcp\",\n \"disabled\": false\n }\n }\n}\n```\n\nOr Bob panel → MCP tab → **Edit Global MCP**. Bob detects the tools automatically.\n

\n\n> The server scales to zero when idle — if the very first connection attempt fails, retry once\n> (the native binary starts in tens of milliseconds; the platform may take a bit longer to\n> provision the container; subsequent calls are fast, whether your client is stateless or\n> session-based).\n\n## Client examples\n\n- [`examples/java/langchain4j-mcp-client`](https://github.com/eldermoraes/swapi.build/blob/main/examples/java/langchain4j-mcp-client) — ask\n questions in natural language; the tools come from the MCP server above, so the example\n defines none.\n- [`examples/java/quarkus-rest-client`](https://github.com/eldermoraes/swapi.build/blob/main/examples/java/quarkus-rest-client) — call the REST\n API from Java with a typed client.\n\n## Project Structure\n\n```\nswapi-app/\n Dockerfile.vercel # Native container image used by Vercel deploys\n src/main/\n java/com/eldermoraes/ # Backend (Quarkus + Jakarta REST)\n film/ # Film model, service, resource\n people/ # People model, service, resource\n planet/ # Planet model, service, resource\n specie/ # Specie model, service, resource\n starship/ # Starship model, service, resource\n vehicle/ # Vehicle model, service, resource\n mcp/ # MCP server tools (sw_list, sw_get, sw_random, sw_search)\n SWObject.java # Base model class\n SWService.java # Service interface\n ApiResource.java # Root /api endpoint\n ApplicationPath.java # Jakarta REST base path (/api)\n resources/\n data/ # Static JSON data files\n application.properties # Quarkus configuration\n webui/ # Frontend (TypeScript + Vite)\n src/\n api.ts # API client with request management\n main.ts # SPA router\n pages/ # Page renderers (home, resource, docs, mcp, about, privacy, terms)\n json-highlight.ts # JSON syntax highlighting for result panels\n style.css # Site styles\n types.ts # TypeScript interfaces for API resources\n constants.ts # Shared resource metadata\n utils.ts # Shared utilities (escapeHtml)\n src/test/\n java/com/eldermoraes/ # Regression suite (REST contracts, MCP tools, forwarded headers)\n```\n\nEach backend domain (film, people, planet, etc.) follows the same pattern:\n\n- **Model** (e.g., `Film.java`): POJO with `@RegisterForReflection` for native image support\n- **Service** (e.g., `FilmService.java`): loads data from JSON at startup, caches in memory\n- **Resource** (e.g., `FilmResource.java`): Jakarta REST controller with `@RunOnVirtualThread`\n\n## Build\n\n```bash\ncd swapi-app\n\n# Development mode (live reload)\n./mvnw quarkus:dev\n\n# Production JAR\n./mvnw package\njava -jar target/quarkus-app/quarkus-run.jar\n\n# Native executable (requires GraalVM or container build)\n./mvnw package -Dnative\n./mvnw package -Dnative -Dquarkus.native.container-build=true\n```\n\nThe frontend is automatically built and bundled by [Quinoa](https://docs.quarkiverse.io/quarkus-quinoa/dev/index.html) during the Maven build. No separate `npm` step is needed.\n\n## Deployment\n\nThe app runs on [Vercel](https://vercel.com/) as a native (GraalVM/Mandrel) container image, built from `swapi-app/Dockerfile.vercel`. DNS is managed on Cloudflare (DNS-only records pointing to Vercel). Deploys are done with `npx vercel deploy --prod` from the `swapi-app/` directory.\n\n## Tech Stack\n\n- **Runtime:** [Quarkus 3.33](https://quarkus.io/) on Java 25 with Virtual Threads\n- **MCP server:** [Quarkiverse MCP Server](https://docs.quarkiverse.io/quarkus-mcp-server/dev/index.html) — Streamable HTTP, stateless and session-based clients\n- **Serialization:** Jakarta REST + JSON-B\n- **Native image:** GraalVM via Mandrel builder\n- **Frontend:** TypeScript + [Vite](https://vite.dev/), served by Quinoa\n\n## Contributing\n\nPull requests are always welcome. Whether it's fixing a bug, improving the docs, or adding new features, jump in and help make the best Star Wars API in the galaxy even better.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/my-change`)\n3. Make your changes (with tests) and run the suite: `cd swapi-app && ./mvnw test`\n4. Commit and push\n5. Open a Pull Request\n\n## Changelog and releases\n\nRelease history lives in [CHANGELOG.md](https://github.com/eldermoraes/swapi.build/blob/main/CHANGELOG.md). Tagged releases are on the\n[Releases page](https://github.com/eldermoraes/swapi.build/releases). The version\nserved in `/openapi.json` (`info.version`) is always the latest released version.\nThe release process itself is documented in [docs/RELEASE.md](https://github.com/eldermoraes/swapi.build/blob/main/docs/RELEASE.md).\n\n## Credits\n\n- Original [SWAPI](https://swapi.dev/) by **Paul Hallett**, maintained by **Juriy Bura**\n- Star Wars data from community-driven sources such as [Wookieepedia](https://starwars.fandom.com/)\n- All Star Wars content and imagery are property of **Lucasfilm Ltd.** and **Disney**. This project is not affiliated with or endorsed by Lucasfilm or Disney.\n\n## License\n\nLicensed under the [Apache License 2.0](https://github.com/eldermoraes/swapi.build/blob/main/LICENSE). The website also publishes a\n[Privacy Policy](https://swapi.build/privacy) and [Terms of Use](https://swapi.build/terms).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","topics",[],"license","Apache-2.0","language","Java","registryName","build.swapi/star-wars","homepage","https://swapi.build","packages",[],"ENV",{"_112":113,"_114":115,"_116":117},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

Star Wars MCP