{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_khgzbctk29pj","handle":"yonglelaoren-openapi-mcp","url":"https://wellknown.network/agents/yonglelaoren-openapi-mcp","links":{"self":"https://wellknown.network/agents/yonglelaoren-openapi-mcp/record.json","html":"https://wellknown.network/agents/yonglelaoren-openapi-mcp","markdown":"https://wellknown.network/agents/yonglelaoren-openapi-mcp/record.md","api":"https://wellknown.network/api/v1/agents/yonglelaoren-openapi-mcp","status":"https://wellknown.network/api/v1/agents/yonglelaoren-openapi-mcp/status","claim":"https://wellknown.network/agents/yonglelaoren-openapi-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yonglelaoren-openapi-mcp/claim.json","badge":"https://wellknown.network/agents/yonglelaoren-openapi-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yonglelaoren-openapi-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yonglelaoren-openapi-mcp","summary":"OpenAPI MCP Server - 基于 Model Context Protocol 的 OpenAPI 规范解析服务器","description":"# OpenAPI MCP Server\n\n基于 Model Context Protocol 的 OpenAPI 规范解析服务器。\n\n## 功能特性\n\n- 解析 OpenAPI 3.0 规范（支持本地文件和远程 URL）\n- 列出规范中的所有接口\n- 获取接口的详细信息（参数、请求体、响应等）\n- 自动展开 `$ref` 引用\n- 支持循环引用处理\n- 支持深层嵌套结构解析\n- 可选的 server URL 拼接功能\n\n## 安装\n\n使用 uvx：\n\n```bash\nuvx yonglelaoren-openapi-mcp\n```\n\n或使用 pip：\n\n```bash\npip install yonglelaoren-openapi-mcp\n```\n\n## MCP 工具\n\n### list_endpoints\n\n列出 OpenAPI 规范中的所有接口。\n\n**参数：**\n- `spec_source`: OpenAPI 规范来源（文件路径或 URL）\n\n**返回：**\n- 接口列表，包含路径、方法、摘要和描述\n\n### get_endpoint_details\n\n获取指定接口的详细信息，包括参数、请求体、响应等，所有 `$ref` 引用已展开为具体字段结构。\n\n**参数：**\n- `spec_source`: OpenAPI 规范来源（文件路径或 URL）\n- `path`: 接口路径（例如：/users/{id}）\n- `method`: HTTP 方法（GET, POST, PUT, DELETE 等）\n\n**返回：**\n- 接口详细信息，包含参数、请求体、响应、解析后的 schemas 等\n\n## 环境变量\n\n### INCLUDE_SERVER_URL\n\n控制是否在返回的接口路径中包含 server URL 前缀。\n\n**默认值：** `false`\n\n**作用：**\n- 当设置为 `true` 时，如果 OpenAPI 规范中定义了 `servers` 字段，返回的接口路径会包含第一个 server 的 URL 前缀\n- 当设置为 `false` 或未设置时，返回原始的接口路径\n\n**支持的值（启用）：**\n- `true`\n- `True`\n- `1`\n- `yes`\n\n**支持的值（禁用）：**\n- `false`\n- `False`\n- `0`\n- `no`\n\n**示例：**\n\n假设 OpenAPI 规范中定义：\n```yaml\nservers:\n  - url: /video-service\n\npaths:\n  /mvc/test/hello:\n    get:\n      summary: 测试接口\n```\n\n- **默认行为（INCLUDE_SERVER_URL=false）**：\n  ```json\n  {\n    \"path\": \"/mvc/test/hello\"\n  }\n  ```\n\n- **启用 server URL（INCLUDE_SERVER_URL=true）**：\n  ```json\n  {\n    \"path\": \"/video-service/mvc/test/hello\"\n  }\n  ```\n\n**使用场景：**\n在微服务架构中，不同的服务可能有不同的 URL 前缀。启用此功能可以在返回的接口路径中自动包含服务前缀，便于区分不同服务的接口地址。\n\n## 配置示例\n\n### 在 Claude Desktop 中配置\n\n编辑 Claude Desktop 的配置文件（通常位于 `~/Library/Application Support/Claude/claude_desktop_config.json`）：\n\n```json\n{\n  \"mcpServers\": {\n    \"openapi-extraction\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"run\",\n        \"--directory\",\n        \"/path/to/openapi-mcp\",\n        \"yonglelaoren-openapi-mcp\"\n      ],\n      \"env\": {\n        \"INCLUDE_SERVER_URL\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### 使用 uvx\n\n```bash\nuvx -e INCLUDE_SERVER_URL=true yonglelaoren-openapi-mcp\n```\n\n### 使用环境变量\n\n```bash\nexport INCLUDE_SERVER_URL=true\nuvx yonglelaoren-openapi-m…","publisher":null,"homepage":null,"repository":null,"version":"0.4.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:yonglelaoren-openapi-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.apis","name":"API Access","confidence":1,"provenance":"derived"}],"categories":["data"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"yonglelaoren-openapi-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:27.297Z","publishedAt":"2026-08-22T01:57:00.467357Z","latestVersion":"0.4.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yonglelaoren-openapi-mcp","url":"https://pypi.org/project/yonglelaoren-openapi-mcp/","firstSeenAt":"2026-09-10T16:23:23.014Z","fetchedAt":"2026-09-10T16:23:23.014Z","normalizedAt":"2026-09-10T16:23:23.014Z"}]},"firstSeenAt":"2026-09-10T16:23:23.014Z","updatedAt":"2026-09-10T16:24:27.297Z"}