MCP Starwars

🚀 星球大战 MCP サーバー

このサーバーは、星球大戦に関連する情報を取得したり操作したりするための機能を提供します。GitHub Copilotと連携して、便利なツールを利用できます。

⚠️ 重要提示

もしClaude Desktopを使用したMCPサーバーを有効にしている場合は、VS Codeの設定にchat.mcp.discovery.enabled: trueを追加すると、既存のMCPサーバーリストを検出できます。

MCPサーバーを特定のリポジトリに関連付ける場合は、リポジトリ内に.vscode/mcp.jsonファイルを作成し、以下の内容を記述します。

{
  "inputs": [],
  "servers": {
    "mcp-starwars": {
      "command": "npx",
      // "command": "node",
      "args": [
        "-y",
        "@johnpapa/mcp-starwars"
        // "_git/mcp-starwars/dist/index.js"
      ],
      "env": {}
    }
  }
}

MCPサーバーをすべてのリポジトリに関連付ける場合は、VS Codeのユーザー設定JSONに以下の内容を追加します。

"mcp": {
  "servers": {
    "mcp-starwars": {
      "command": "npx",
      // "command": "node",
      "args": [
        "-y",
        "@johnpapa/mcp-starwars"
        // "/Users/papa/_git/mcp-starwars/dist/index.js"
        // "_git/mcp-starwars/dist/index.js"
      ],
      "env": {}
    }
  }
}
"chat.mcp.discovery.enabled": true,

🚀 クイックスタート

GitHub Copilotでのツールの使用方法

1. MCPサーバーが検出可能になったら、GitHub Copilotを開き、Agentモード（ChatやEditsではない）を選択します。

2. Copilotチャットのテキストフィールドで「刷新」ボタンを選択して、サーバーリストを更新します。

3. 「🛠️」ボタンを選択して、すべての利用可能なツールを表示します。これには、このリポジトリ内のツールも含まれます。

4. チャットで、ツールを呼び出す自然な質問を入力します。例えば：

   如何设置我的VS Code渐变颜色？
   

   ⚠️ 重要提示

   「申し訳ありません、応答は責任あるAIサービスによってフィルタリングされました。言い換えて再試行してください。」と表示された場合は、再度実行するか、プロンプトを言い換えてください。

✨ 主な機能

19個の利用可能な関数

以下は、サポートされている19の機能です。

映画情報の取得

星球大戦の映画情報を取得します。

/**
 * 星球大戦の映画情報を取得します。
 * @param queryParams クエリパラメータ
 * @returns 映画データの配列
 */
async getFilms(queryParams?: Record<string, unknown>): Promise<unknown[]>;

人物情報の取得

人物情報を取得します。

/**
 * 人物情報を取得します。
 * @param queryParams クエリパラメータ
 * @returns 人物データの配列
 */
async getPeople(queryParams?: Record<string, unknown>): Promise<unknown[]>;

宇宙船情報の取得

宇宙船情報を取得します。

/**
 * 宇宙船情報を取得します。
 * @param queryParams クエリパラメータ
 * @returns 宇宙船データの配列
 */
async getStarships(queryParams?: Record<string, unknown>): Promise<unknown[]>;

種族情報の取得

種族情報を取得します。

/**
 * 種族情報を取得します。
 * @param queryParams クエリパラメータ
 * @returns 種族データの配列
 */
async getSpecies(queryParams?: Record<string, unknown>): Promise<unknown[]>;

惑星情報の取得

惑星情報を取得します。

/**
 * 惑星情報を取得します。
 * @param queryParams クエリパラメータ
 * @returns 惑星データの配列
 */
async getPlanets(queryParams?: Record<string, unknown>): Promise<unknown[]>;

交通機関情報の取得

交通機関情報を取得します。

/**
 * 交通機関情報を取得します。
 * @param queryParams クエリパラメータ
 * @returns 交通機関データの配列
 */
async getVehicles(queryParams?: Record<string, unknown>): Promise<unknown[]>;

全リソース情報の取得

すべてのリソースの情報を取得します。

/**
 * すべてのリソースの情報を取得します。
 * @param queryParams クエリパラメータ
 * @returns すべてのリソースのデータ配列
 */
async getEverything(queryParams?: Record<string, unknown>): Promise<unknown[]>;

映画の作成

新しい映画エントリを作成します。

/**
 * 新しい映画エントリを作成します。
 * @param body リクエストボディ
 * @returns 新しい映画データ
 */
async createFilms(body: unknown): Promise<unknown>;

映画の更新

既存の映画エントリの情報を更新します。

/**
 * 既存の映画エントリの情報を更新します。
 * @param id 映画ID
 * @param body リクエストボディ
 * @returns 更新後の映画データ
 */
async updateFilms(id: string, body: unknown): Promise<unknown>;

映画の削除

既存の映画エントリを削除します。

/**
 * 既存の映画エントリを削除します。
 * @param id 映画ID
 * @returns 削除確認
 */
async deleteFilms(id: string): Promise<void>;

IDによる映画情報の取得

IDを使用して特定の映画情報を取得します。

/**
 * IDを使用して特定の映画情報を取得します。
 * @param id 映画ID
 * @returns 特定の映画データ
 */
async getFilmByID(id: string): Promise<unknown>;

人物の作成

新しいキャラクターエントリを作成します。

/**
 * 新しいキャラクターエントリを作成します。
 * @param body リクエストボディ
 * @returns 新しいキャラクターデータ
 */
async createPeople(body: unknown): Promise<unknown>;

人物の更新

既存のキャラクターエントリの情報を更新します。

/**
 * 既存のキャラクターエントリの情報を更新します。
 * @param id キャラクターID
 * @param body リクエストボディ
 * @returns 更新後のキャラクターデータ
 */
async updatePeople(id: string, body: unknown): Promise<unknown>;

人物の削除

既存のキャラクターエントリを削除します。

/**
 * 既存のキャラクターエントリを削除します。
 * @param id キャラクターID
 * @returns 削除確認
 */
async deletePeople(id: string): Promise<void>;

IDによる人物情報の取得

IDを使用して特定の人物情報を取得します。

/**
 * IDを使用して特定の人物情報を取得します。
 * @param id キャラクターID
 * @returns 特定のキャラクターデータ
 */
async getPersonByID(id: string): Promise<unknown>;

宇宙船の作成

新しい宇宙船エントリを作成します。

/**
 * 新しい宇宙船エントリを作成します。
 * @param body リクエストボディ
 * @returns 新しい宇宙船データ
 */
async createStarships(body: unknown): Promise<unknown>;

宇宙船の更新

既存の宇宙船エントリの情報を更新します。

/**
 * 既存の宇宙船エントリの情報を更新します。
 * @param id 宇宙船ID
 * @param body リクエストボディ
 * @returns 更新後の宇宙船データ
 */
async updateStarships(id: string, body: unknown): Promise<unknown>;

宇宙船の削除

既存の宇宙船エントリを削除します。

/**
 * 既存の宇宙船エントリを削除します。
 * @param id 宇宙船ID
 * @returns 削除確認
 */
async deleteStarships(id: string): Promise<void>;

IDによる宇宙船情報の取得

IDを使用して特定の宇宙船情報を取得します。

/**
 * IDを使用して特定の宇宙船情報を取得します。
 * @param id 宇宙船ID
 * @returns 特定の宇宙船データ
 */
async getStarshipByID(id: string): Promise<unknown>;

📦 インストール

VS Code拡張機能を使用したインストール

1. VS Codeを開きます。
2. 拡張機能ビューに移動します（ショートカット：Ctrl+Shift+X）。
3. 「Star Wars MCP Server」拡張機能を検索してインストールします。

コマンドラインを使用したインストール

Node.jsとnpmのインストール

# 先下载并安装Node.js和npm
# https://nodejs.org/

MCPサーバーのインストール

npm install -g starwars-mcp-server

Smitheryを使用したインストール

smithery add @johnpapa/starwars-mcp-server

📚 ドキュメント

サーバーの起動

starwars-mcp-server start

サーバーの停止

starwars-mcp-server stop

サーバーの再起動

starwars-mcp-server restart

💻 使用例

全映画情報の取得

await getEverything();

新しいキャラクターの作成

const person = {
  name: "Luke Skywalker",
  height: "172",
  mass: "77",
  hair_color: "blond",
  skin_color: "fair"
};

await createPeople(person);

🔧 注意事項

• サーバーが正しくインストールされ、実行されていることを確認してください。
• ネットワーク接続を確認し、サービスにアクセスできることを確認してください。
• エラーや例外状況を適切に処理してください。

このドキュメントが、Star Wars MCP Serverの使用を支援することができれば幸いです。何か問題があれば、サポートチームにお問い合わせください。