API operation

io.github.ladanyin由 GitHub 账号 ladanyin 发布v1.0.0更新于 Nov 5, 2026

Read one operation from a public OpenAPI document: method, path, and required fields.

已验证Streamable HTTP可网页运行知识与记忆开发者工具

概览

AI 生成的概览

远程 MCP 服务器，从公开的 OpenAPI、Swagger 或简单 YAML 文档中读取单个操作，返回方法、路径和必填字段。

可以做什么
  • 通过文档 URL 和简短意图（例如“创建宠物”）从公开的 OpenAPI/Swagger JSON 或简单 YAML 文档中查找一个 API 操作。
  • 返回最匹配的结果，包括方法、路径、操作 id、摘要以及必填参数和请求体字段。
适用场景
当助手需要在调用公开 API 前，从规范文档中找到正确的端点及其必填输入，又不想把整份文档塞进上下文时适用。
运行要求
远程 streamable HTTP 端点，无需本地安装。需要 API 密钥，通过 X-API-Key 请求头发送，需在提供方网站注册获取。README 说明新密钥含 20 个额度，更多额度需另行购买。
安装前请注意
API 密钥是每次调用都要发送的机密，请勿写入日志或共享记录。调用会消耗付费额度（README 列出了该提供方其他工具的按次价格及欧元计价的额度包），可能产生费用。文档 URL 和意图会发送到提供方服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 API operation，将其添加到工作区。
  2. 连接 X-API-Key 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.ladanyin%2Fapi-operation/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "api-operation": {
      "type": "http",
      "url": "https://spec.bestsmartgoods.com/mcp",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

Company lookup, invoice reading, citation check

Three remote MCP servers for other agents. One API key. New keys include 20 credits.

Get a key: https://firm.bestsmartgoods.com/signup

Buy credits: https://firm.bestsmartgoods.com/buy

Send the key on every call:

X-API-Key: ak_...

Company lookup

Find a company by name, registration number, or tax id. 0.05 credit per successful call.

MCP: https://firm.bestsmartgoods.com/mcp · tool lookup_company

bash
curl -X POST https://firm.bestsmartgoods.com/v1/companies/lookup \
  -H "X-API-Key: ak_..." \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"MOL Magyar Olaj\",\"country\":\"HU\"}"

Invoice reading

Read an invoice or text file into seller, tax id, date, and amounts. 0.15 credit per successful call.

MCP: https://bill.bestsmartgoods.com/mcp · tool parse_invoice

bash
curl -X POST https://bill.bestsmartgoods.com/v1/invoices/parse \
  -H "X-API-Key: ak_..." \
  -F "[email protected]"

Citation check

[mcptry]

Check whether a URL supports a claim. 0.08 credit per successful call.

MCP: https://cite.bestsmartgoods.com/mcp · tool check_citation

bash
curl -X POST https://cite.bestsmartgoods.com/v1/citations/check \
  -H "X-API-Key: ak_..." \
  -H "Content-Type: application/json" \
  -d "{\"claim\":\"Example Domain is for use in documentation examples\",\"url\":\"https://example.com\"}"

Prices

  • 100 credits = 5 EUR
  • 500 credits = 20 EUR
  • 2000 credits = 60 EUR

来源：README.md，提交 3b6e3d2

工具

1

lookup_operation

Read one API operation

Read one operation from a public OpenAPI or Swagger JSON document, or from a simple YAML document. Returns the method, path, operation id, summary, and required parameter and body fields. Send the document URL and a short intent, for example create a pet. The best text match is returned. A private address, a login wall, or a document with no matching operation is not charged. The first 5 successful reads each UTC day from one network address are free and need no key. After the 5, send X-API-Key. A key call costs 0.04 credit when an operation is returned. Do not send a URL on a private network. Key: https://firm.bestsmartgoods.com/signup

输入参数url必填query必填

版本历史

1
  1. v1.0.0最新Nov 5, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。