Petstore MCP Server

ai.com.mcp由 mcp.com.ai 发布官方发布者v0.6.0更新于 Oct 24, 2026

Swagger Petstore API (v1.0.27) as MCP for testing and prototyping powered by the HAPI MCP server

已验证Streamable HTTP可网页运行开发者工具商业与电商

概览

AI 生成的概览

远程 MCP 端点，封装 Swagger Petstore 示例 API，让助手管理宠物、订单、库存和用户，用于测试与原型开发。

可以做什么
  • 新增、更新和删除宠物，按 ID、状态或标签查询宠物
  • 为宠物上传图片文件
  • 按状态查看库存数量
  • 下单、按 ID 查询和删除购买订单
  • 创建、登录、登出、查询、更新和删除商店用户
适用场景
适合想用知名示例 API 试用 MCP 工具调用、演示助手调用 REST 风格工具的能力，或在不自建后端的情况下搭建智能体流程原型。
运行要求
远程 streamable HTTP 端点；未声明任何软件包、环境变量或请求头。清单声明无需认证，但部分用户工具说明只能由已登录用户执行。
安装前请注意
工具会写入和删除数据：可创建、修改或删除宠物、订单和用户，也可上传文件。用户工具包含登录和登出，且清单声明无认证，因此发送的数据不应视为私密。这是公开演示商店，不是生产系统。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Petstore MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

{
  "mcpServers": {
    "petstore": {
      "type": "http",
      "url": "https://petstore.run.mcp.com.ai/mcp"
    }
  }
}

README

HAPI MCP – Headless API for Model Context Protocol

Stop rewriting systems for AI. Instantly turn your APIs into MCP servers.

HAPI MCP lifts your OpenAPI catalog into MCP tools automatically, keeping design (OAS/Arazzo) and runtime (agents/LLMs) cleanly separated. Your existing APIs become AI-ready tools—no new business logic, no sidecar servers, no rework.

Key Features

  • No rewrites: Reuse 100% of your API logic. OpenAPI in, MCP tools out. No parallel codebase or shadow services.
  • Faster time-to-value: Turn specs into agent-ready tools in minutes. Update the spec, ship new tools instantly.
  • Reduced risk: Permissions, auth, rate limits, auditability are inherited from your APIs—governance without bolt-ons.
  • Scales with you: runMCP delivers serverless-like elasticity with long-running when needed. Cold-start fast, stay warm for throughput.
  • Deterministic orchestration: OrcA plans and executes multi-tool tasks predictably—no brittle prompt chaining.
  • Vendor-neutral: Works with any MCP client: ChatGPT, Claude, QBot, chatMCP. OAS + MCP + Arazzo stay portable.

How It Works

  1. Pick your API spec

    • OpenAPI, Swagger, REST—HAPI CLI works with any API specification format.
    • Supports OpenAPI 3.0+, REST APIs, OAuth 2.0 Dynamic Client Registration.

  2. Run a single command

    • One simple CLI command transforms your API into a usable MCP Server.
    • No complex setup, zero configuration, works anywhere, cross-platform.

  3. Use instantly

    • Your API is now ready as a tool, AI agent, or testing interface.
    • MCP server ready, AI agent compatible, testing interface, developer experience friendly.

Visual Pipeline

API Spec (swagger.json) → HAPI CLI → Usable Tool (AI-ready) ← MCP Clients
[ OpenAPI / Swagger ]       [ HAPI CLI ]        [ MCP Server ]       (Your API)         →   (Transform)   →   (Usable Tool)                                                 ↑          ↑                                                 |          |                                          [ ChatGPT ]  [ runMCP ]                                          [ Claude  ]  [ OrcA   ]                                          [ QBot    ]  [ chatMCP]                                          [ Agents  ]

Who Wins With HAPI

  • Executives: Ship AI initiatives without ballooning cost. Keep teams focused on outcomes, not rewrites and integration sprawl.
  • Architects & PMs: Design with OpenAPI/Arazzo, run with MCP. Clear contracts, policy inheritance, and versioned workflows keep risk low.
  • Engineers & Ops: Deploy once. HAPI Server + runMCP scale tools; QBot/chatMCP give fast feedback; OrcA keeps executions deterministic.

Your Stack, Already Wired

  • HAPI Server: Turns OpenAPI into MCP tools automatically—contracts stay in sync with your source of truth.
  • runMCP: Autoscaling execution and testing for MCP tools; cold-start fast, stay warm when workflows run long.
  • QBot: CLI TUI for power users to interact with MCP tools directly from terminal or scripts.
  • chatMCP: Conversational client that speaks MCP natively for support, ops, and internal assistants.
  • OrcA: Deterministic planning and orchestration for multi-tool tasks; no brittle prompt spaghetti.
  • Agents: Build agentic systems from standard APIs—no custom glue. Connect MCP clients across platforms.

Demos

Documentation

FAQ

  • Do we need to rewrite our services?
    No. HAPI MCP lifts your existing OpenAPI specs directly into MCP tools. Your auth, validation, and business rules remain unchanged.

  • Is this just another MCP server?
    It’s the Headless API model: your API becomes the runtime. HAPI Server reflects it as MCP; runMCP scales it; OrcA orchestrates it. No duplicate logic.

  • Which clients can consume the tools?
    Any MCP client: ChatGPT, Claude, QBot, chatMCP, bespoke orchestrators—vendor-neutral by design.

  • How do we keep control and compliance?
    Your API remains the single source of truth. Policies, RBAC, rate limits, and audit logs flow through automatically; no shadow logic.

  • What about security and privacy?
    Scoped credentials, per-tool permissions, and auditable calls are inherited from your API layer. HAPI adds guardrails and observability for regulated environments.

  • How fast can we get started?
    You can transform your first API into an MCP tool in less than five minutes. The HAPI CLI makes it quick and painless.

Get Started

  1. Install HAPI CLI from latest release: https://github.com/la-rebelion/hapimcp/releases

  2. Transform your OpenAPI spec into an MCP server with a single command:

    bash
    hapi serve path/to/your/swagger.json --headless

  3. Start using your MCP tools with any compatible client!

  4. Explore the documentation for advanced usage and best practices.

Contributing

Contributions are welcome! Open a discussion or submit a pull request on GitHub: https://github.com/la-rebelion/hapimcp

License

HAPI MCP is licensed under the MIT License. See LICENSE for details.

来源：README.md，提交 1873ff7

工具

19

updatePet

Update an existing pet. - Update an existing pet by Id.

输入参数updatePetBody必填x-hapi-auth-state

addPet

Add a new pet to the store. - Add a new pet to the store.

输入参数addPetBody必填x-hapi-auth-state

findPetsByStatus

Finds Pets by status. - Multiple status values can be provided with comma separated strings.

输入参数status必填x-hapi-auth-state

findPetsByTags

Finds Pets by tags. - Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.

输入参数tags必填x-hapi-auth-state

getPetById

Find pet by ID. - Returns a single pet.

输入参数petId必填x-hapi-auth-state

updatePetWithForm

Updates a pet in the store with form data. - Updates a pet resource based on the form data.

输入参数namepetId必填statusx-hapi-auth-state

deletePet

Deletes a pet. - Delete a pet.

输入参数petId必填api_keyx-hapi-auth-state

uploadFile

Uploads an image. - Upload image of the pet.

输入参数petId必填uploadFileBodyx-hapi-auth-stateadditionalMetadata

getInventory

Returns pet inventories by status. - Returns a map of status codes to quantities.

输入参数x-hapi-auth-state

placeOrder

Place an order for a pet. - Place a new order in the store.

输入参数placeOrderBodyx-hapi-auth-state

getOrderById

Find purchase order by ID. - For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.

输入参数orderId必填x-hapi-auth-state

deleteOrder

Delete purchase order by identifier. - For valid response try integer IDs with value < 1000. Anything above 1000 or non-integers will generate API errors.

输入参数orderId必填x-hapi-auth-state

createUser

Create user. - This can only be done by the logged in user.

输入参数createUserBodyx-hapi-auth-state

createUsersWithListInput

Creates list of users with given input array. - Creates list of users with given input array.

输入参数x-hapi-auth-statecreateUsersWithListInputBody

loginUser

Logs user into the system. - Log into the system.

输入参数passwordusernamex-hapi-auth-state

logoutUser

Logs out current logged in user session. - Log user out of the system.

输入参数x-hapi-auth-state

getUserByName

Get user by user name. - Get user detail based on username.

输入参数username必填x-hapi-auth-state

updateUser

Update user resource. - This can only be done by the logged in user.

输入参数username必填updateUserBodyx-hapi-auth-state

deleteUser

Delete user resource. - This can only be done by the logged in user.

输入参数username必填x-hapi-auth-state

版本历史

1
  1. v0.6.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

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

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