tutorial typescript swapi-MCP-server

🌟 MCP星球大战API服务器

 ](https://nodejs.org/) 

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

📖 关于项目

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

🎥 学习资源

• 📺 视频教程: 从 TypeScript 到 MCP
• 📝 完整文章: 教程编号DEV.to
• 🐙 原始仓库: swapi mcp服务器应用程序

✨ 功能

🔧 可用工具

📚 可用资源

🚀 如何执行

先决条件

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

1. 安装

# Clone o repositório
git clone 
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

🛠️ 使用的技术

• **** -运行时JavaScript
• TypeScript - 静态打字和安全
• MCP-SDK MCP 官方 SDK
• 阿西奥斯 用于 API 调用的 HTTP 客户端
• 萨德 - 方案和类型的验证
• 斯瓦皮 -星球大战API（API pública）
• 克劳德桌面 -MCP客户端

📋 使用范例

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

角色

• “查找有关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许可证。查看文件 许可证 了解更多详情。

🙏 致谢

• 格劳西亚·莱莫斯 - 出色的教程和灵感
• 斯瓦皮 - 惊人的星球大战API
• Anthropic Claude Desktop 和 MCP

🔗 链接乌斯

• 模型上下文协议
• 克劳德桌面
• 星球大战API
• 教程原创

______________________________________________________________________

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