mcpField
S
swapi-mcp

swapi-mcp

本地服务
github.com/abhishekjkrsna游戏娱乐013 周前更新
代码仓库

关于 swapi-mcp

swapi-mcp 是一个 TypeScript MCP 服务，供兼容 MCP 的客户端访问 Star Wars API（SWAPI）的部分数据。它提供列出数据类别和获取角色信息的工具。

主要功能

  1. 01从 SWAPI 获取指定数据
  2. 02列出 Star Wars 数据类别
  3. 03获取角色信息
  4. 04使用 Zod 验证工具架构

适用场景

  1. 01查询 Star Wars 角色详情
  2. 02查看可用的 SWAPI 数据类别

MCP 相关

该服务通过 stdio 将 SWAPI 数据作为 MCP 工具提供给兼容客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "abhishekjkrsna-swapi": {
      "command": "npx",
      "args": [
        "-y",
        "@abhishekjkrsna/swapi-mcp"
      ]
    }
  }
}
启动命令npx -y @abhishekjkrsna/swapi-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@abhishekjkrsna/swapi-mcp1.0.4

工具

3

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

SWAPI MCP

一个基于 TypeScript 的模型上下文协议（MCP）服务，可将《星球大战》API 数据作为 MCP 工具提供。

此项目连接到《星球大战》API（SWAPI），并通过 stdio 传输方式向兼容 MCP 的客户端提供精选的《星球大战》信息。

功能

  • 使用 TypeScript 构建的 MCP 服务
  • 基于 stdio 的 MCP 传输
  • 从 SWAPI 获取《星球大战》数据
  • 使用 Zod 验证工具架构
  • 包含 Vitest 测试设置
  • 支持覆盖率报告

技术栈

  • TypeScript
  • Node.js
  • 模型上下文协议 SDK
  • Zod
  • Vitest
  • tsx

项目结构

text swapi-mcp/ ├── src/ # 源代码 ├── tests/ # 测试文件和模拟数据 │ ├── api/ │ └── mock_data/ ├── package.json ├── package-lock.json ├── tsconfig.json └── vitest.config.js

要求

  • Node.js 20 或更高版本
  • npm

部分 MCP 相关依赖要求 Node.js 20 或更高版本，因此建议使用最新的 LTS 版本。

安装

npm install

克隆仓库并安装依赖：

可用脚本

启动开发服务

npm run start

使用 tsx 直接从 TypeScript 启动 MCP 服务。

构建项目

npm run build

使用 TypeScript 编译器将 TypeScript 编译为 JavaScript。

运行测试

npm run test

启动后，服务会通过 stdio 连接，可供兼容 MCP 的客户端使用。

可用工具

get-list-of-star-wars-information

返回 SWAPI 中可用《星球大战》信息类别的逗号分隔列表，例如：

  • 人物
  • 行星
  • 电影
  • 物种
  • 载具
  • 星舰
get-information-of-star-wars-characters

返回此项目的角色工具提供的《星球大战》角色信息。

MCP 客户端配置示例

你可以配置兼容 MCP 的客户端，使用 npm 运行此服务：

{ "mcpServers": { "swapi-mcp": { "command": "npm", "args": ["start"] } } }

如果你的客户端要求使用绝对工作目录，请按如下方式配置：

{ "mcpServers": { "swapi-mcp": { "command": "npm", "args": ["start"], "cwd": "/absolute/path/to/swapi-mcp" } } }

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。