Petstore MCP Server
Swagger Petstore API (v1.0.27) as MCP for testing and prototyping powered by the HAPI MCP server
我该使用它吗
质量与安全性
发现(2)
- LOW在 getInventory 中
- LOW在 placeOrder 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"petstore": {
"url": "https://petstore.run.mcp.com.ai/mcp"
}
}
}远程端点
https://petstore.run.mcp.com.ai/mcpstreamable-http它能做什么
工具清单
工具(19)
🟡updatePet(updatePetBody, x-hapi-auth-state)
Update an existing pet. - Update an existing pet by Id.
输入模式
{
"type": "object",
"properties": {
"updatePetBody": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
},
"category": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
}
}
},
"photoUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
}
}
}
},
"status": {
"type": "string",
"enum": [
"available",
"pending",
"sold"
],
"description": "pet status in the store"
}
},
"required": [
"name",
"photoUrls"
]
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"updatePetBody"
]
}🟡addPet(addPetBody, x-hapi-auth-state)
Add a new pet to the store. - Add a new pet to the store.
输入模式
{
"type": "object",
"properties": {
"addPetBody": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
},
"category": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
}
}
},
"photoUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
}
}
}
},
"status": {
"type": "string",
"enum": [
"available",
"pending",
"sold"
],
"description": "pet status in the store"
}
},
"required": [
"name",
"photoUrls"
]
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"addPetBody"
]
}⚪findPetsByStatus(status, x-hapi-auth-state)
Finds Pets by status. - Multiple status values can be provided with comma separated strings.
输入模式
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"available",
"pending",
"sold"
]
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"status"
]
}⚪findPetsByTags(tags, x-hapi-auth-state)
Finds Pets by tags. - Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing.
输入模式
{
"type": "object",
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"tags"
]
}🟢getPetById(petId, x-hapi-auth-state)
Find pet by ID. - Returns a single pet.
输入模式
{
"type": "object",
"properties": {
"petId": {
"type": "integer",
"format": "int64"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"petId"
]
}⚪updatePetWithForm(petId, name, status, x-hapi-auth-state)
Updates a pet in the store with form data. - Updates a pet resource based on the form data.
输入模式
{
"type": "object",
"properties": {
"petId": {
"type": "integer",
"format": "int64"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"petId"
]
}🔴deletePet(api_key, petId, x-hapi-auth-state)
Deletes a pet. - Delete a pet.
输入模式
{
"type": "object",
"properties": {
"api_key": {
"type": "string"
},
"petId": {
"type": "integer",
"format": "int64"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"petId"
]
}🟡uploadFile(petId, additionalMetadata, uploadFileBody, x-hapi-auth-state)
Uploads an image. - Upload image of the pet.
输入模式
{
"type": "object",
"properties": {
"petId": {
"type": "integer",
"format": "int64"
},
"additionalMetadata": {
"type": "string"
},
"uploadFileBody": {
"type": "string",
"format": "binary"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"petId"
]
}⚪getInventory(x-hapi-auth-state)
Returns pet inventories by status. - Returns a map of status codes to quantities.
输入模式
{
"type": "object",
"properties": {
"x-hapi-auth-state": {
"type": "string"
}
}
}⚪placeOrder(placeOrderBody, x-hapi-auth-state)
Place an order for a pet. - Place a new order in the store.
输入模式
{
"type": "object",
"properties": {
"placeOrderBody": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"petId": {
"type": "integer",
"format": "int64"
},
"quantity": {
"type": "integer",
"format": "int32"
},
"shipDate": {
"type": "string",
"format": "date-time"
},
"status": {
"type": "string",
"enum": [
"placed",
"approved",
"delivered"
],
"description": "Order Status"
},
"complete": {
"type": "boolean"
}
}
},
"x-hapi-auth-state": {
"type": "string"
}
}
}🟢getOrderById(orderId, x-hapi-auth-state)
Find purchase order by ID. - For valid response try integer IDs with value <= 5 or > 10. Other values will generate exceptions.
输入模式
{
"type": "object",
"properties": {
"orderId": {
"type": "integer",
"format": "int64"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"orderId"
]
}🔴deleteOrder(orderId, x-hapi-auth-state)
Delete purchase order by identifier. - For valid response try integer IDs with value < 1000. Anything above 1000 or non-integers will generate API errors.
输入模式
{
"type": "object",
"properties": {
"orderId": {
"type": "integer",
"format": "int64"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"orderId"
]
}🟡createUser(createUserBody, x-hapi-auth-state)
Create user. - This can only be done by the logged in user.
输入模式
{
"type": "object",
"properties": {
"createUserBody": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"username": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"email": {
"type": "string"
},
"password": {
"type": "string"
},
"phone": {
"type": "string"
},
"userStatus": {
"type": "integer",
"format": "int32",
"description": "User Status"
}
}
},
"x-hapi-auth-state": {
"type": "string"
}
}
}🟢createUsersWithListInput(createUsersWithListInputBody, x-hapi-auth-state)
Creates list of users with given input array. - Creates list of users with given input array.
输入模式
{
"type": "object",
"properties": {
"createUsersWithListInputBody": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"username": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"email": {
"type": "string"
},
"password": {
"type": "string"
},
"phone": {
"type": "string"
},
"userStatus": {
"type": "integer",
"format": "int32",
"description": "User Status"
}
}
}
},
"x-hapi-auth-state": {
"type": "string"
}
}
}⚪loginUser(username, password, x-hapi-auth-state)
Logs user into the system. - Log into the system.
输入模式
{
"type": "object",
"properties": {
"username": {
"type": "string"
},
"password": {
"type": "string"
},
"x-hapi-auth-state": {
"type": "string"
}
}
}⚪logoutUser(x-hapi-auth-state)
Logs out current logged in user session. - Log user out of the system.
输入模式
{
"type": "object",
"properties": {
"x-hapi-auth-state": {
"type": "string"
}
}
}🟢getUserByName(username, x-hapi-auth-state)
Get user by user name. - Get user detail based on username.
输入模式
{
"type": "object",
"properties": {
"username": {
"type": "string"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"username"
]
}🟡updateUser(username, updateUserBody, x-hapi-auth-state)
Update user resource. - This can only be done by the logged in user.
输入模式
{
"type": "object",
"properties": {
"username": {
"type": "string"
},
"updateUserBody": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"username": {
"type": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"email": {
"type": "string"
},
"password": {
"type": "string"
},
"phone": {
"type": "string"
},
"userStatus": {
"type": "integer",
"format": "int32",
"description": "User Status"
}
}
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"username"
]
}🔴deleteUser(username, x-hapi-auth-state)
Delete user resource. - This can only be done by the logged in user.
输入模式
{
"type": "object",
"properties": {
"username": {
"type": "string"
},
"x-hapi-auth-state": {
"type": "string"
}
},
"required": [
"username"
]
}推荐提示词
findPetsByStatusfindPetsByStatusgetPetByIdgetPetByIdcreateUsersWithListInput社区
证据