Swapi

mcp-swapi

SWAPI MCP — Star Wars API（無料、認証不要）をラップします

Pipeworx の一部です — AI エージェントを1683以上のライブデータソースに接続するMCPゲートウェイです。

ツール

ツール	説明
search_people	名前でStar Warsのキャラクターを検索します。名前、身体的特徴、生年、性別、故郷の惑星のURLを返します。
get_planet	数値IDでStar Warsの惑星を取得します。名前、気候、地形、人口、軌道データを返します。
get_starship	数値IDでStar Warsの宇宙船を取得します。名前、モデル、製造元、乗員定員、ハイパードライブの評価を返します。
get_film	数値IDでStar Warsの映画を取得します。タイトル、エピソード番号、監督、プロデューサー、公開日、オープニングクロールを返します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurfなど）に追加します：

{
  "mcpServers": {
    "swapi": {
      "url": "https://gateway.pipeworx.io/swapi/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/swapi/mcp の tools/list は、上記の表にあるツールに加えて、Pipeworx共通のメタツール — ask_pipeworx、 discover_tools、search_within、remember／recallなど、ゲートウェイ全体で使えるツール群を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共通ツールが約30個表示されます。接続の initialize 応答には、その時点での正確な対象範囲が記載されており、当日の正式な情報となります。

これは意図的なものであり、偶然に多重化されているわけではありません。メタツールを使うことで、このパックが扱わない質問にも、カタログ全体を横断してルーティングする ask_pipeworx 経由で回答でき、MCP サーバーをもう1つ追加する必要がありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマがもたらすコンテキストコストがルーティングの価値を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworxのフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1683以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。ask_pipeworxを使えば、どちらからでもすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/swapi_search_people \
  -H 'Content-Type: application/json' \
  -d '{"query":"Luke"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/swapi_search_peopleを使います。ツールを検索するには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを使います。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルのstdio MCP サーバーとしても実行できます。Pipeworxアカウントも、ゲートウェイへの往復通信も不要です：

{
  "mcpServers": {
    "swapi": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-swapi"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-swapi

stdin/stdout経由でMCPを使用し、このパック独自のツールのみについて、initialize／tools/list／tools/callに応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworxによるルーティングはありません。

ask_pipeworxを使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントとフルゲートウェイのどちらでも使えます：

ask_pipeworx({ question: "your question about Swapi data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT