{"id":29245,"date":"2025-03-24T03:59:03","date_gmt":"2025-03-23T19:59:03","guid":{"rendered":"https:\/\/www.aisharenet.com\/?p=29245"},"modified":"2025-03-24T03:59:03","modified_gmt":"2025-03-23T19:59:03","slug":"openapi-mcp-server","status":"publish","type":"post","link":"https:\/\/www.kdjingpai.com\/ja\/openapi-mcp-server\/","title":{"rendered":"openapi-mcp-server\uff1a\u8ba9AI\u76f4\u63a5\u8c03\u7528\u5f00\u653eAPI\u7684MCP\u670d\u52a1"},"content":{"rendered":"<p>openapi-mcp-server \u662f\u4e00\u4e2a\u5f00\u6e90\u5de5\u5177\uff0c\u65e8\u5728\u5c06\u7b26\u5408 OpenAPI v3.1 \u6807\u51c6\u7684API\u8f6c\u5316\u4e3aAI\u53ef\u7528\u7684\u8d44\u6e90\u3002\u5b83\u7531 janwilmake \u7ef4\u62a4\uff0c\u57fa\u4e8e Model Context Protocol\uff08MCP\uff09\u534f\u8bae\u5f00\u53d1\u3002\u9879\u76ee\u7684\u6838\u5fc3\u529f\u80fd\u662f\u5145\u5f53API\u4ee3\u7406\uff0c\u8ba9\u5f00\u53d1\u8005\u901a\u8fc7 <a href=\"https:\/\/www.kdjingpai.com\/en\/claudeanquanfubai\/\">Claude<\/a> Desktop \u7b49\u5de5\u5177\u76f4\u63a5\u4e0eAPI\u4ea4\u4e92\u3002\u8fd9\u4e2a\u5de5\u5177\u7279\u522b\u9002\u5408\u9700\u8981\u5feb\u901f\u96c6\u6210API\u7684\u5f00\u53d1\u8005\u548cAI\u5de5\u7a0b\u5e08\u3002\u5b83\u7684\u8bbe\u8ba1\u7b80\u5355\u76f4\u63a5\uff0c\u5f00\u6e90\u5728 GitHub \u4e0a\uff0c\u4efb\u4f55\u4eba\u90fd\u53ef\u4ee5\u514d\u8d39\u4f7f\u7528\u6216\u8d21\u732e\u4ee3\u7801\u3002<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-29246\" title=\"openapi-mcp-server\uff1a\u8ba9AI\u76f4\u63a5\u8c03\u7528\u5f00\u653eAPI\u7684MCP\u670d\u52a1-1\" src=\"https:\/\/www.kdjingpai.com\/wp-content\/uploads\/2025\/03\/6df89372dc5d9ee.png\" alt=\"openapi-mcp-server\uff1a\u8ba9AI\u76f4\u63a5\u8c03\u7528\u5f00\u653eAPI\u7684MCP\u670d\u52a1-1\" width=\"1112\" height=\"657\" srcset=\"https:\/\/www.kdjingpai.com\/wp-content\/uploads\/2025\/03\/6df89372dc5d9ee.png 1112w, https:\/\/www.kdjingpai.com\/wp-content\/uploads\/2025\/03\/6df89372dc5d9ee-768x454.png 768w, https:\/\/www.kdjingpai.com\/wp-content\/uploads\/2025\/03\/6df89372dc5d9ee-18x12.png 18w\" sizes=\"auto, (max-width: 1112px) 100vw, 1112px\" \/><\/p>\n<p>&nbsp;<\/p>\n<h2>\u529f\u80fd\u5217\u8868<\/h2>\n<ul>\n<li><strong>API\u8f6cMCP\u4ee3\u7406<\/strong>\uff1a\u5c06 OpenAPI \u89c4\u8303\u7684\u7aef\u70b9\u8f6c\u4e3a Claude \u53ef\u7528\u7684\u5de5\u5177\u3002<\/li>\n<li><strong>\u652f\u6301\u591a\u79cd\u683c\u5f0f<\/strong>\uff1a\u53ef\u4ee5\u5c06API\u8f6c\u6362\u4e3a OpenAI\u3001Anthropic \u6216 <a href=\"https:\/\/www.kdjingpai.com\/en\/model-context-protocol\/\">MCP<\/a> \u5de5\u5177\u683c\u5f0f\u3002<\/li>\n<li><strong>\u547d\u4ee4\u884c\u64cd\u4f5c<\/strong>\uff1a\u63d0\u4f9b CLI \u5de5\u5177\uff0c\u65b9\u4fbf\u7a0b\u5e8f\u5316\u8c03\u7528API\u3002<\/li>\n<li><strong>\u793a\u4f8b\u670d\u52a1\u5668<\/strong>\uff1a\u5185\u7f6e Petstore API \u793a\u4f8b\uff0c\u5e2e\u52a9\u7528\u6237\u5feb\u901f\u4e0a\u624b\u3002<\/li>\n<li><strong>\u5f00\u6e90\u514d\u8d39<\/strong>\uff1a\u4ee3\u7801\u516c\u5f00\uff0c\u7528\u6237\u53ef\u81ea\u7531\u4fee\u6539\u548c\u6269\u5c55\u3002<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2>\u4f7f\u7528\u5e2e\u52a9<\/h2>\n<p>openapi-mcp-server \u4e0d\u9700\u8981\u590d\u6742\u5b89\u88c5\uff0c\u76f4\u63a5\u901a\u8fc7 GitHub \u83b7\u53d6\u6e90\u7801\u540e\u8fd0\u884c\u3002\u4ee5\u4e0b\u662f\u8be6\u7ec6\u6b65\u9aa4\u3002<\/p>\n<h3>\u5b89\u88c5\u4e0e\u8fd0\u884c<\/h3>\n<ol>\n<li><strong>\u51c6\u5907\u73af\u5883<\/strong><br \/>\n\u786e\u4fdd\u4f60\u7684\u7535\u8111\u5b89\u88c5\u4e86 Node.js \u548c pnpm\uff08\u63a8\u8350\uff09\u3002\u53ef\u4ee5\u7528\u547d\u4ee4\u68c0\u67e5\uff1a<\/li>\n<\/ol>\n<pre><code>node -v\r\npnpm -v\r\n<\/code><\/pre>\n<p>\u5982\u679c\u6ca1\u6709\uff0c\u8bbf\u95ee\u00a0<code>https:\/\/nodejs.org<\/code>\u00a0\u548c\u00a0<code>https:\/\/pnpm.io<\/code>\u00a0\u4e0b\u8f7d\u5b89\u88c5\u3002<br \/>\n2.\u00a0<strong>\u514b\u9686\u4ed3\u5e93<\/strong><br \/>\n\u6253\u5f00\u7ec8\u7aef\uff0c\u8f93\u5165\uff1a<\/p>\n<pre><code>git clone https:\/\/github.com\/janwilmake\/openapi-mcp-server.git\r\ncd openapi-mcp-server\r\n<\/code><\/pre>\n<ol start=\"3\">\n<li><strong>\u5b89\u88c5\u4f9d\u8d56<\/strong><br \/>\n\u5728\u9879\u76ee\u76ee\u5f55\u8fd0\u884c\uff1a<\/li>\n<\/ol>\n<pre><code>pnpm install\r\n<\/code><\/pre>\n<ol start=\"4\">\n<li><strong>\u6784\u5efa\u9879\u76ee<\/strong><br \/>\n\u6784\u5efa\u4ee3\u7801\u4ee5\u786e\u4fdd\u6b63\u5e38\u8fd0\u884c\uff1a<\/li>\n<\/ol>\n<pre><code>pnpm build\r\n<\/code><\/pre>\n<ol start=\"5\">\n<li><strong>\u94fe\u63a5\u5168\u5c40\u547d\u4ee4<\/strong><br \/>\n\u8ba9\u547d\u4ee4\u884c\u5de5\u5177\u53ef\u7528\uff1a<\/li>\n<\/ol>\n<pre><code>npm link\r\n<\/code><\/pre>\n<h3>\u914d\u7f6e Claude Desktop<\/h3>\n<ol>\n<li><strong>\u7f16\u8f91\u914d\u7f6e\u6587\u4ef6<\/strong><br \/>\n\u627e\u5230 Claude Desktop \u7684\u914d\u7f6e\u6587\u4ef6\uff0c\u901a\u5e38\u5728\uff1a<\/li>\n<\/ol>\n<ul>\n<li>Windows:\u00a0<code>%AppData%\\Claude\\claude_desktop_config.json<\/code><\/li>\n<li>Mac:\u00a0<code>~\/Library\/Application Support\/Claude\/claude_desktop_config.json<\/code><br \/>\n\u5982\u679c\u6ca1\u6709\uff0c\u521b\u5efa\u4e00\u4e2a\u65b0\u6587\u4ef6\u3002<\/li>\n<\/ul>\n<ol start=\"2\">\n<li><strong>\u6dfb\u52a0 MCP \u670d\u52a1\u5668<\/strong><br \/>\n\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u52a0\u5165\u4ee5\u4e0b\u5185\u5bb9\uff1a<\/li>\n<\/ol>\n<pre><code>{\r\n\"mcpServers\": {\r\n\"petstore-api\": {\r\n\"<a href=\"https:\/\/www.kdjingpai.com\/en\/cohere\/\">command<\/a>\": \"npx\",\r\n\"args\": [\"openapi-mcp-server\", \"\/path\/to\/petstore-openapi.json\"]\r\n}\r\n}\r\n}\r\n<\/code><\/pre>\n<p>\u5c06\u00a0<code>\/path\/to\/petstore-openapi.json<\/code>\u00a0\u66ff\u6362\u4e3a\u4f60\u7684 OpenAPI \u6587\u4ef6\u8def\u5f84\uff0c\u6bd4\u5982\u9879\u76ee\u4e2d\u7684\u00a0<code>examples\/petstore-openapi.json<\/code>\u3002<br \/>\n3.\u00a0<strong>\u542f\u52a8 Claude Desktop<\/strong><br \/>\n\u8fd0\u884c Claude Desktop\uff0c\u5b83\u4f1a\u81ea\u52a8\u52a0\u8f7d\u6b64\u670d\u52a1\u5668\u3002<\/p>\n<h3>\u4f7f\u7528 CLI \u8c03\u7528API<\/h3>\n<ol>\n<li><strong>\u51c6\u5907 OpenAPI \u6587\u4ef6<\/strong><br \/>\n\u786e\u4fdd\u4f60\u6709\u76ee\u6807API\u7684 OpenAPI v3.1 JSON \u6587\u4ef6\uff0c\u6bd4\u5982\u00a0<code>petstore-openapi.json<\/code>\u3002<\/li>\n<li><strong>\u8fd0\u884c\u547d\u4ee4<\/strong><br \/>\n\u5728\u7ec8\u7aef\u8f93\u5165\uff1a<\/li>\n<\/ol>\n<pre><code>npx openapi-mcp-server \/path\/to\/your-openapi.json\r\n<\/code><\/pre>\n<p>\u8fd9\u4f1a\u542f\u52a8\u4e00\u4e2a\u4ee3\u7406\u670d\u52a1\u5668\u3002<br \/>\n3.\u00a0<strong>\u6d4b\u8bd5 Petstore \u793a\u4f8b<\/strong><br \/>\n\u9879\u76ee\u81ea\u5e26\u4e00\u4e2a Petstore API \u793a\u4f8b\u3002\u8fd0\u884c\uff1a<\/p>\n<pre><code>npx openapi-mcp-server examples\/petstore-openapi.json\r\n<\/code><\/pre>\n<p>\u7136\u540e\u5728 Claude Desktop \u4e2d\u4e0e\u5b83\u4ea4\u4e92\uff0c\u6bd4\u5982\u8f93\u5165\u201cget pet by ID\u201d\u3002<\/p>\n<h3>\u7a0b\u5e8f\u5316\u8f6c\u6362API<\/h3>\n<ol>\n<li><strong>\u5bfc\u5165\u6a21\u5757<\/strong><br \/>\n\u5728\u4f60\u7684 Node.js \u9879\u76ee\u4e2d\uff0c\u6dfb\u52a0\u4ee3\u7801\uff1a<\/li>\n<\/ol>\n<pre><code>import { OpenAPIToMCPConverter } from 'openapi-mcp-server';\r\n<\/code><\/pre>\n<ol start=\"2\">\n<li><strong>\u8f6c\u6362API<\/strong><br \/>\n\u4f7f\u7528\u4ee5\u4e0b\u4ee3\u7801\u5c06 OpenAPI \u8f6c\u4e3a\u5de5\u5177\u683c\u5f0f\uff1a<\/li>\n<\/ol>\n<pre><code>const converter = new OpenAPIToMCPConverter(openApiSpec); \/\/ openApiSpec \u662f\u4f60\u7684 JSON \u6570\u636e\r\nconst openAiTools = await converter.convertToOpenAITools(); \/\/ \u8f6c\u4e3a OpenAI \u683c\u5f0f\r\nconst mcpTools = converter.convertToMCPTools(); \/\/ \u8f6c\u4e3a MCP \u683c\u5f0f\r\n<\/code><\/pre>\n<ol start=\"3\">\n<li><strong>\u8c03\u7528API<\/strong><br \/>\n\u4f7f\u7528 HttpClient \u6267\u884c\u8bf7\u6c42\uff1a<\/li>\n<\/ol>\n<pre><code>import { HttpClient } from 'openapi-mcp-server';\r\nconst httpClient = new HttpClient({ baseUrl: 'https:\/\/api.example.com' }, openApiSpec);\r\nconst response = await httpClient.executeOperation(mcpTools.openApiLookup['getPetById'], { petId: 123 });\r\n<\/code><\/pre>\n<h3>\u64cd\u4f5c\u5efa\u8bae<\/h3>\n<ul>\n<li><strong>\u8c03\u8bd5\u95ee\u9898<\/strong>\uff1a\u5982\u679c Claude \u5d29\u6e83\uff0c\u68c0\u67e5 OpenAPI \u6587\u4ef6\u662f\u5426\u89c4\u8303\uff0c\u53ef\u7528\u00a0<code>https:\/\/editor.swagger.io<\/code>\u00a0\u9a8c\u8bc1\u3002<\/li>\n<li><strong>\u66f4\u65b0\u4ee3\u7801<\/strong>\uff1a\u4fee\u6539\u4ee3\u7801\u540e\uff0c\u8fd0\u884c\u00a0<code>pnpm build<\/code>\u00a0\u5e76\u91cd\u542f Claude Desktop\u3002<\/li>\n<li><strong>\u5b66\u4e60\u793a\u4f8b<\/strong>\uff1a\u67e5\u770b\u00a0<code>examples\/README.md<\/code>\uff0c\u4e86\u89e3 Petstore \u670d\u52a1\u5668\u7684 CRUD \u64cd\u4f5c\u3002<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<h2>\u5e94\u7528\u573a\u666f<\/h2>\n<ol>\n<li><strong>\u5feb\u901fAPI\u96c6\u6210<\/strong><br \/>\n\u5f00\u53d1\u8005\u60f3\u4e3a\u9879\u76ee\u6dfb\u52a0\u5ba0\u7269\u7ba1\u7406\u529f\u80fd\u3002\u4ed6\u7528 openapi-mcp-server \u52a0\u8f7d Petstore API\uff0c\u5728 Claude \u4e2d\u76f4\u63a5\u6d4b\u8bd5\u7aef\u70b9\uff0c\u7701\u53bb\u624b\u52a8\u7f16\u5199\u4ee3\u7801\u7684\u65f6\u95f4\u3002<\/li>\n<li><strong>AI\u8f85\u52a9\u5f00\u53d1<\/strong><br \/>\nAI\u5de5\u7a0b\u5e08\u9700\u8981\u751f\u6210API\u8c03\u7528\u4ee3\u7801\u3002\u4ed6\u901a\u8fc7\u5de5\u5177\u8f6c\u6362 OpenAPI \u6587\u4ef6\uff0c\u7528 Claude \u751f\u6210\u5b8c\u6574\u8bf7\u6c42\u4ee3\u7801\u3002<\/li>\n<li><strong>\u6559\u5b66\u6f14\u793a<\/strong><br \/>\n\u8001\u5e08\u7528 Petstore \u793a\u4f8b\uff0c\u5411\u5b66\u751f\u5c55\u793a\u5982\u4f55\u5c06API\u63a5\u5165AI\u5de5\u5177\uff0c\u5b66\u4e60API\u4ea4\u4e92\u3002<\/li>\n<\/ol>\n<p>&nbsp;<\/p>\n<h2>QA<\/h2>\n<ol>\n<li><strong>\u9700\u8981\u4ed8\u8d39\u5417\uff1f<\/strong><br \/>\n\u4e0d\u9700\u8981\uff0c\u9879\u76ee\u5b8c\u5168\u5f00\u6e90\u514d\u8d39\uff0c\u6258\u7ba1\u5728 GitHub \u4e0a\u3002<\/li>\n<li><strong>\u652f\u6301\u54ea\u4e9bAPI\uff1f<\/strong><br \/>\n\u53ea\u8981\u662f OpenAPI v3.1 \u89c4\u8303\u7684API\u90fd\u53ef\u4ee5\uff0c\u6bd4\u5982 GitHub\u3001Cloudflare \u7b49\u3002<\/li>\n<li><strong>Claude \u4e0d\u8bc6\u522b\u600e\u4e48\u529e\uff1f<\/strong><br \/>\n\u68c0\u67e5\u914d\u7f6e\u6587\u4ef6\u8def\u5f84\u548c OpenAPI \u6587\u4ef6\u662f\u5426\u6b63\u786e\uff0c\u786e\u4fdd\u670d\u52a1\u5668\u5df2\u542f\u52a8\u3002<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>openapi-mcp-server \u662f\u4e00\u4e2a\u5f00\u6e90\u5de5\u5177\uff0c\u65e8\u5728\u5c06\u7b26\u5408 OpenAPI v3.1 \u6807\u51c6\u7684API\u8f6c\u5316\u4e3aAI\u53ef\u7528\u7684\u8d44\u6e90\u3002\u5b83\u7531 janwilmake \u7ef4\u62a4\uff0c\u57fa\u4e8e Model Context Protocol\uff08MCP\uff09\u534f\u8bae\u5f00\u53d1\u3002\u9879\u76ee\u7684\u6838\u5fc3&#8230;<\/p>\n","protected":false},"author":1,"featured_media":62090,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[20],"tags":[230,387],"class_list":["post-29245","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tool","tag-aikaiyuanxiangmu","tag-mcpfuwu"],"_links":{"self":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/posts\/29245","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/comments?post=29245"}],"version-history":[{"count":0,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/posts\/29245\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/media\/62090"}],"wp:attachment":[{"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/media?parent=29245"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/categories?post=29245"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.kdjingpai.com\/ja\/wp-json\/wp\/v2\/tags?post=29245"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}