toolcast (Djsand)

MCP运维云端

提供方 Djsand · 包名 toolcast

运维云端 stdio · 本地进程 API Key 社区 / 第三方 ClaudeCursor
查看接入方式

toolcast是一个将任何OpenAPI规范转换为AI代理工具的解决方案,通过简单命令即可创建MCP服务器,支持多种API调用。

一句话选型结论

按资料字段整理

toolcast (Djsand) 属于运维云端类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 5 仓库热度,无公开仓库时显示未标注
工具数 7 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量7暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

API代理TypeScript本地部署OpenAPI转换MCP服务器AI工具集成

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
npx toolcast serve https://petstore3.swagger.io/api/v3/openapi.json

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 7 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 7 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
toolcast (Djsand)当前 7 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Djsand上游标注的维护方 Djsand
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时toolcast · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.6 KB
来自项目仓库与上游目录的原文,未做删改

toolcast

Turn any API into an AI agent tool. One command.

Point at an OpenAPI spec. Get a working MCP server in 10 seconds.

Your AI agent can now call Stripe, GitHub, Slack, Notion — or any API with a spec.

Quick Start •
Registry •
How It Works •
Examples •
Contributing


问题

您希望您的人工智能代理调用API。今天你必须:

  1. 为特定的API查找或构建MCP服务器
  2. 编写工具定义、参数模式、身份验证处理
  3. 测试、调试、部署
  4. 对每个新的API重复

toolcast在一个命令中完成所有这些。

快速开始```bash

Try it right now with the demo Petstore API (no auth needed)

npx toolcast serve https://petstore3.swagger.io/api/v3/openapi.json


就是这样。你的人工智能代理现在有19个工具来管理宠物、订单和用户。

### 添加一个真正的API```bash
# Add Stripe to your Claude Code config
npx toolcast add stripe

# Or point at any OpenAPI spec
npx toolcast serve https://api.example.com/openapi.json --bearer-token $MY_TOKEN

上菜前检查```bash

See what tools would be generated

npx toolcast inspect https://petstore3.swagger.io/api/v3/openapi.json
``````
Swagger Petstore v1.0.27

19 Tools:

addPet POST /pet (1 params)
updatePet PUT /pet (1 params)
findPetsByStatus GET /pet/findByStatus (1 params)
getPetById GET /pet/{petId} (1 params)
getInventory GET /store/inventory (0 params)
placeOrder POST /store/order (1 params)
createUser POST /user (1 params)
...


## 注册表

toolcast附带了流行API的预构建配置。添加它们的一个命令:

|API |命令|获得的内容|
|-----|---------|-------------|
| **GitHub** | `toolcast add github` |repo、问题、PR、操作、用户|
| **条纹** | `toolcast add stripe` |付款、订阅、发票|
| **Slack** | `toolcast add slack` |消息、渠道、用户、反应|
| **概念** | `toolcast add notion` |页面、数据库、块、搜索|
| **线性** | `toolcast add linear` |问题、项目、团队、周期|
| **OpenAI** | `toolcast add openai` |完成、嵌入、图像|
| **宠物店** | `toolcast add petstore` |用于测试的演示API|
```bash
# List all available APIs
toolcast list

# Search by keyword
toolcast search payments

想要添加API吗? 看 贡献.

运作原理```

+-----------------+
OpenAPI Spec ---> | toolcast | ---> MCP Server (stdio)
(URL or file) | | ready for Claude Code,
| 1. Parse spec | Cursor, or any MCP client
| 2. Build tools |
| 3. Handle auth |
+-----------------+


1. **解析** --读取任何OpenAPI 3.0/3.1规范(JSON或YAML、URL或文件)。解决 `$ref`s、 提取端点、参数和身份验证方案。

1. **构建工具** -每个API端点都成为一个MCP工具,具有:

- 人类可读的名称(来自 `operationId`)
- 清晰的描述(来自 `summary` + `description`)
- 类型化的输入模式(来自参数+请求体)
- 正确的参数处理(路径、查询、标头、正文)

1. **服务** -启动一个stdio MCP服务器,该服务器使用正确的身份验证、头和错误格式将工具调用代理到真正的API。

## 例子

### 与Claude Code一起使用

添加到您的 `.mcp.json`:```json
{
"mcpServers": {
"my-api": {
"command": "npx",
"args": ["toolcast", "serve", "https://api.example.com/openapi.json"],
"env": {
"API_TOKEN": "your-token-here"
}
}
}
}

或者使用 add 自动配置命令:```bash
toolcast add github

Adds to .mcp.json automatically


### 与本地规范文件一起使用```bash
toolcast serve ./my-api-spec.yaml --base-url https://localhost:3000

以编程方式使用```typescript

import { parseSpec, createMcpServer } from "toolcast";

const spec = await parseSpec("https://api.example.com/openapi.json");
const server = createMcpServer(spec, {
baseUrl: "https://api.example.com",
auth: { type: "bearer", value: process.env.API_TOKEN },
});


## 认证

toolcast支持三种身份验证方法,可从OpenAPI规范中自动检测:

|方法|环境变量|标志|
|--------|--------------|------|
| **持有者令牌** | `API_TOKEN`, `BEARER_TOKEN`, `AUTH_TOKEN` | `--bearer-token` |
| **API密钥** | `API_KEY`,或源自方案名称| `--api-key` |
| **基本认证** | `API_USER` + `API_PASSWORD` | — |

注册表项指定要使用哪个env变量(例如。, `GITHUB_TOKEN` GitHub)。

## CLI参考```
toolcast serve        Start MCP server from OpenAPI spec
--base-url         Override base URL
--api-key          API key auth
--bearer-token   Bearer token auth

toolcast inspect      Preview tools without starting server

toolcast add          Add registry API to .mcp.json
--config          Config file path (default: .mcp.json)

toolcast list               List all registry APIs
toolcast search      Search registry
toolcast --version          Show version
toolcast --help             Show help

贡献

将API添加到注册表

  1. 在中创建一个YAML文件 registry/:```yaml
    name: my-api
    displayName: My API
    description: What this API does
    specUrl: https://example.com/openapi.json
    baseUrl: https://api.example.com
    authType: bearer
    authEnvVar: MY_API_KEY
    tags:
    - category
    - keywords

2. 提交PR。就是这样。

### 发展```bash
git clone https://github.com/your-username/toolcast.git
cd toolcast
npm install
npm run build
npm test

# Test locally
node dist/cli.js inspect https://petstore3.swagger.io/api/v3/openapi.json

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
toolcast (Djsand) 怎么安装?

在客户端按下面的安装命令接入:npx toolcast serve https://petstore3.swagger.io/api/v3/openapi.json。对应的包名是 toolcast。装完在客户端配置里引用同一个包或端点。

toolcast (Djsand) 怎么在 Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

toolcast (Djsand) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

toolcast (Djsand) 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

toolcast (Djsand) 支持哪些客户端?

资料标注支持 Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

toolcast (Djsand) 能提供哪些能力?

资料显示约 7 个工具;能力标签包括 API代理、TypeScript、Claude、AI工具集成。具体工具清单以官方文档为准。

toolcast (Djsand) 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

toolcast (Djsand) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。