AI导哈

Star Wars API服务

一个基于Model Context Protocol (MCP)的TypeScript服务器，集成Star Wars API (SWAPI)与Claude Desktop，允许用户查询Star Wars宇宙中的角色、星球、电影等详细信息。

  • by leonardopadilha
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 leonardopadilha/tutorial_typescript_swapi-mcp-server

使用说明

🌟 MCP星球大战API服务器

一个服务器 模型上下文协议（MCP） 使用TypeScript开发，将星球大战API（SWAPI）与Claude Desktop集成。它允许您直接通过Claude询问有关星球大战宇宙的问题，并获得有关角色，行星，电影等的详细信息。

📖 关于项目

这个项目是基于教程 从零到MCP：使用TypeScript和星球大战API创建服务器模型上下文协议 开发者 格劳西亚·莱莫斯.

🎥 学习资源

✨ 功能

🔧 可用工具

工具 说明 使用示例
search_characters 按名字搜索星球大战角色 “查找Luke Skywalker的信息”
search_planets 按名称搜索星球大战行星 “查找Tatooine的数据”
search_films 按标题搜索星球大战电影 “搜索电影 新希望”
get_character_by_id 通过 ID 获取角色的详细信息 “查找具有 ID 4 的角色”

📚 可用资源

资源 描述 URI
all_films 所有《星球大战》系列电影按剧集排序 swapi://films/all

🚀 如何执行

先决条件

  • Node.js （版本 18 或更高）
  • 克劳德桌面 instalado
  • npm 哦 纱线

1. 安装

# Clone o repositório
git clone <seu-repositorio>
cd mcp_api_star_wars

# Instale as dependências
npm install

2. 汇编

# Compile o TypeScript
npm run build

# Ou use o modo watch para desenvolvimento
npm run watch

3. Claude 桌面设置

将以下设置添加到您的文件 claude_desktop_config.json:

{
  "mcpServers": {
    "swapi-mcp-server": {
      "command": "node",
      "args": [
        "C:\\caminho\\para\\seu\\projeto\\build\\index.js"
      ]
    }
  }
}

4. 检查员测试（可选）

# Teste o servidor MCP com o inspector
npm run inspector

5. 执行

# Execute o servidor
npm start

🏗️ 项目结构

mcp_api_star_wars/
├── src/
│   ├── index.ts          # Servidor MCP + Lógica das Tools
│   └── types.ts          # Interfaces TypeScript (People, Planets, Films)
├── build/                # Arquivos JS compilados
├── package.json          # Dependências e scripts
├── tsconfig.json         # Configuração TypeScript
├── claude_desktop_config.json  # Configuração do MCP Client
└── README.md            # Este arquivo

🛠️ 使用的技术

📋 使用范例

设置服务器后，您可以提出以下问题：

角色

  • “查找有关Luke Skywalker的信息”
  • “寻找金发角色”
  • “显示 ID 1 的角色”

行星

  • “查找Tatooine的数据”
  • “寻找气候干燥的行星”
  • “显示人口大于1000000的行星”

电影

  • 电影《新希望》（A New Hope）
  • “显示所有传奇电影”
  • “查找乔治·卢卡斯执导的电影”

🔧 可用脚本

npm run build      # Compila o TypeScript
npm run start      # Executa o servidor
npm run watch      # Compila em modo watch
npm run inspector  # Testa com MCP Inspector
npm run prepare    # Executa build antes de publicar

🤝 贡献

  1. 创建项目分叉
  2. 为您的功能创建一个分支 （git checkout -b feature/AmazingFeature)
  3. 提交您的更改（git commit -m 'Add some AmazingFeature')
  4. 推动一个分支(git push origin feature/AmazingFeature)
  5. Abra um Pull请求

📝 许可证

这个项目是根据ISC许可证。查看文件 许可证 了解更多详情。

🙏 致谢

🔗 链接乌斯

愿原力（和密码）与你同在！ ⭐✨

相关 MCP