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 分