MCP Starwars

🚀 星球大戰 MCP 服務器

本項目是星球大戰 MCP 服務器，可提供星球大戰相關的各類信息，如電影、人物、宇宙飛船等，還支持對這些信息進行創建、更新和刪除等操作。

🚀 快速開始

啟用 MCP 服務器發現

⚠️ 重要提示

如果您已經啟用了帶有Claude Desktop的MCP服務器，請在VS Code設置中添加chat.mcp.discovery.enabled: true，它將發現現有的MCP服務器列表。

關聯 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漸變顏色？

⚠️ 重要提示

如果您看到“抱歉，響應被負責任的人工智能服務過濾。請重新措辭並重試。”，請再次運行或重新措辭提示。

✨ 主要特性

19個可用函數

以下是支持的19個功能：

獲取films

獲取星球大戰中的電影信息。

/**
 * 獲取星球大戰中的電影信息。
 * @param queryParams 查詢參數
 * @returns 影片數據數組
 */
async getFilms(queryParams?: Record<string, unknown>): Promise<unknown[]>;

獲取people

獲取人物信息。

/**
 * 獲取人物信息。
 * @param queryParams 查詢參數
 * @returns 人物數據數組
 */
async getPeople(queryParams?: Record<string, unknown>): Promise<unknown[]>;

獲取starships

獲取宇宙飛船信息。

/**
 * 獲取宇宙飛船信息。
 * @param queryParams 查詢參數
 * @returns 宇宙飛船數據數組
 */
async getStarships(queryParams?: Record<string, unknown>): Promise<unknown[]>;

獲取species

獲取物種信息。

/**
 * 獲取物種信息。
 * @param queryParams 查詢參數
 * @returns 物種數據數組
 */
async getSpecies(queryParams?: Record<string, unknown>): Promise<unknown[]>;

獲取planets

獲取行星信息。

/**
 * 獲取行星信息。
 * @param queryParams 查詢參數
 * @returns 行星數據數組
 */
async getPlanets(queryParams?: Record<string, unknown>): Promise<unknown[]>;

獲取vehicles

獲取交通工具信息。

/**
 * 獲取交通工具信息。
 * @param queryParams 查詢參數
 * @returns 交通工具數據數組
 */
async getVehicles(queryParams?: Record<string, unknown>): Promise<unknown[]>;

獲取everything

獲取所有資源的信息。

/**
 * 獲取所有資源的信息。
 * @param queryParams 查詢參數
 * @returns 所有資源的數據數組
 */
async getEverything(queryParams?: Record<string, unknown>): Promise<unknown[]>;

創建films

創建新的電影條目。

/**
 * 創建新的電影條目。
 * @param body 請求正文
 * @returns 新的影片數據
 */
async createFilms(body: unknown): Promise<unknown>;

更新films

更新現有電影條目的信息。

/**
 * 更新現有電影條目的信息。
 * @param id 影片ID
 * @param body 請求正文
 * @returns 更新後的影片數據
 */
async updateFilms(id: string, body: unknown): Promise<unknown>;

刪除films

刪除現有電影條目。

/**
 * 刪除現有電影條目。
 * @param id 影片ID
 * @returns 刪除確認
 */
async deleteFilms(id: string): Promise<void>;

獲取filmByID

通過ID獲取特定電影信息。

/**
 * 通過ID獲取特定電影信息。
 * @param id 影片ID
 * @returns 特定影片數據
 */
async getFilmByID(id: string): Promise<unknown>;

創建people

創建新的角色條目。

/**
 * 創建新的角色條目。
 * @param body 請求正文
 * @returns 新的角色數據
 */
async createPeople(body: unknown): Promise<unknown>;

更新people

更新現有角色條目的信息。

/**
 * 更新現有角色條目的信息。
 * @param id 角色ID
 * @param body 請求正文
 * @returns 更新後的角色數據
 */
async updatePeople(id: string, body: unknown): Promise<unknown>;

刪除people

刪除現有角色條目。

/**
 * 刪除現有角色條目。
 * @param id 角色ID
 * @returns 刪除確認
 */
async deletePeople(id: string): Promise<void>;

獲取personByID

通過ID獲取特定人物信息。

/**
 * 通過ID獲取特定人物信息。
 * @param id 角色ID
 * @returns 特定角色數據
 */
async getPersonByID(id: string): Promise<unknown>;

創建starships

創建新的宇宙飛船條目。

/**
 * 創建新的宇宙飛船條目。
 * @param body 請求正文
 * @returns 新的宇宙飛船數據
 */
async createStarships(body: unknown): Promise<unknown>;

更新starships

更新現有宇宙飛船條目的信息。

/**
 * 更新現有宇宙飛船條目的信息。
 * @param id 宇宙飛船ID
 * @param body 請求正文
 * @returns 更新後的宇宙飛船數據
 */
async updateStarships(id: string, body: unknown): Promise<unknown>;

刪除starships

刪除現有宇宙飛船條目。

/**
 * 刪除現有宇宙飛船條目。
 * @param id 宇宙飛船ID
 * @returns 刪除確認
 */
async deleteStarships(id: string): Promise<void>;

獲取starshipByID

通過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

💻 使用示例

基礎用法

獲取所有影片信息

await getEverything();

高級用法

創建新角色

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

await createPeople(person);

📚 詳細文檔

配置說明

啟動服務器

starwars-mcp-server start

停止服務器

starwars-mcp-server stop

重新啟動服務器

starwars-mcp-server restart

注意事項

• 確保服務器已正確安裝並運行。
• 檢查網絡連接，確保可以訪問服務。
• 處理錯誤和異常情況。

希望這個文檔能幫助您順利使用Star Wars MCP Server！如果有任何問題，請隨時聯繫支持團隊。