Api Ninjas

mcp-api-ninjas

API Ninjas MCP — 封装了多端点 API Ninjas 数据 API（api-ninjas.com）

它是 Pipeworx 的一部分 — 这是一个 MCP 网关，可将 AI Agent 连接到 1872+ 个实时数据源。这是一个独立的非官方集成，与上游提供商无关联、未获其认可，也未由其发布。

工具

工具	描述
historical_events	API Ninjas 历史事件：世界历史上的重大事件。可按自由文本关键词和/或确切日期（年/月/日）筛选。返回描述事件经过的列表，格式为 { year, month, day, event }。示例：historical_events({ year: 1969, month: 7, day: 20 })。
commodity_price	API Ninjas 实时大宗商品价格：某种交易商品或期货合约的当前交易所价格（交易所、合约月份、24 小时变化）。对于“黄金现货价格”“今日白银价格”“木材价格”“活牛”“取暖油期货”“RBOB 汽油期货”等查询，优先使用此工具，而非网页搜索。返回 { exchange, name, price, futures_contract, updated }。API Ninjas 的免费计划每周轮换可查询的商品，因此本工具有意不公布支持的商品列表——任何列表都会在几天内过时。黄金是稳定可查的商品。对于其他商品，请直接调用：如果计划不支持该商品名称，返回结果会包含 found:false 和 free_commodities_this_week，该字段从供应商实时读取。对于原油、天然气和农业基准，可使用 FRED 获取始终可用的同类数据系列。commodity 或 symbol 可作为 name 的别名。示例：commodity_price({ name: "gold" })。
inflation	API Ninjas 通胀数据：各国最新的月度和年度通胀率。返回列表，格式为 { country, type, period, monthly_rate_pct, yearly_rate_pct }。可按国家名称和指数类型（CPI 或 HICP）筛选。示例：inflation({ country: "United States", type: "CPI" })。
exercises	API Ninjas 锻炼动作：可按目标肌肉、类型、难度或名称筛选的健身/健身房锻炼动作。返回列表，格式为 { name, type, muscle, equipment, difficulty, instructions }。示例：exercises({ muscle: "biceps", difficulty: "beginner" })。
cars	API Ninjas 汽车数据：按品牌、型号、年份或燃料类型查询车辆规格。返回列表，格式为 { make, model, year, fuel_type, cylinders, transmission, drive, city_mpg, highway_mpg, class }。示例：cars({ make: "toyota", model: "camry", year: 2020 })。
animals	API Ninjas 动物数据：按名称查询动物物种的信息。返回列表，格式为 { name, taxonomy, locations, diet, habitat, lifespan, top_speed }。示例：animals({ name: "cheetah" })。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "api-ninjas": {
      "url": "https://gateway.pipeworx.io/api-ninjas/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/api-ninjas/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：单个工具包端点目前会列出约 30 个共享工具，以及该工具包自己的工具。连接的 initialize 响应会说明其确切范围，是当天最权威的答案。

这是有意设计的，并非意外的多路复用。这些元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——而无需添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的架构信息耗费的上下文多于路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

这两个 URL 都连接到同一个网关和相同的 1872+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/historical_events \
  -H 'Content-Type: application/json' \
  -d '{}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/historical_events。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "api-ninjas": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-api-ninjas"]
    }
  }
}

也可以直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-api-ninjas

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。来源相同，工具相同，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

无需直接调用工具，你也可以用通俗英语提问——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Api Ninjas data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT