{"_id":"@aisf/mcp-client","_rev":"9-86accc9b1b315520c3f364e1e0e67cd3","name":"@aisf/mcp-client","dist-tags":{"latest":"1.0.9"},"versions":{"1.0.1":{"name":"@aisf/mcp-client","version":"1.0.1","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.1","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"0de0d3ed9530d765588e1d28c740d6b80e76087d","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.1.tgz","fileCount":4,"integrity":"sha512-y0iGucOWL8dgqCI09bgICejieaPuYyZv3MOBkKiTZKRQfB8FRhzEGYrZkaXRk/o5gERproqVctXpkGzmLtiEpw==","signatures":[{"sig":"MEUCIANkFCiT+ZapQWafAqLsWfqZ+rZFPzD3K4ezfpSmPtwuAiEAsVuqUcRpvIvfDeusy5tcfCgMQOPkiiqO5BllWWaotSw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24757},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.9.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"22.17.0","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.1_1766803600799_0.6715994926601088","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@aisf/mcp-client","version":"1.0.2","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.2","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"e3119f60f4810cf69ee6f697c05efe0755018a13","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.2.tgz","fileCount":4,"integrity":"sha512-fqzKUGfgg/+ciWmc5gDKFWWngZweSRpQUlVaOk7iREdIyLIQ4LdFMX90gnJVg2Wuk74odXENRFUOMq0TVLKqVA==","signatures":[{"sig":"MEUCIAyeQQHS84n6uMAz9L6daLaQQH7O9TurzMum+LVWphjZAiEA6uj17fdFfL4NUMSZqHkypgalaZsJBU80JJbfXa5C0e0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27190},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.9.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"22.17.0","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.2_1766804485995_0.855033083705377","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@aisf/mcp-client","version":"1.0.3","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.3","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"1dc91fa7af027bd0ccfec1faa1d9613242a77a08","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.3.tgz","fileCount":4,"integrity":"sha512-IS9Ku7bnykvCD0aM5ZSFrVDJP48Z7TT3AweJNnTgl5WcO5oTSdzPQZlzC4oJ5dosSR2kkwYN3H//ge8Mib00wg==","signatures":[{"sig":"MEUCIBGAFRZCt5xPMfE8WRhn+1iS7wLxDKIeaiHeyQBRRgQeAiEAn2qjmaE26qia3roKZoh20ZI53WyiIks8dktOlZUL9Xk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28175},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.9.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"22.17.0","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.3_1766806010524_0.5192027091259475","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@aisf/mcp-client","version":"1.0.4","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.4","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"mcp-client":"src/index.js","aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"9b42d7397b37049d38ec29032b39084dbbaea629","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.4.tgz","fileCount":4,"integrity":"sha512-D4BwJ8b9M5AEwttM4IyF1PZgMq+teQ8Wp5TRqYGeumDEmc+EDc42dH/cR+sOLqFcSzruO7cWsO1oiNOXpsXAUA==","signatures":[{"sig":"MEUCIQDCvH+DMjAmehg6ZcdGxNuTLY6hQIrmucaSeyvoUrI97wIgFCmvx3AB/l7hIwwJmGmWkl7oh8yJ1Kvf0E8ZL8GJPWY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28211},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.8.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"20.19.2","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.4_1766818613504_0.6707935746882601","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@aisf/mcp-client","version":"1.0.5","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.5","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"mcp-client":"src/index.js","aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"19e5684b23745155b88c5b3ce9889c32279187b9","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.5.tgz","fileCount":4,"integrity":"sha512-wT6Ay0CXkQI56OS5gd40uyam0vi/hE5qI5uNZpF5rruPGrk6vFTEj5df/HTKVACpR0SbKbT5Y68/BR/T+qWQDg==","signatures":[{"sig":"MEQCIHjSu5pbdJNUISvuTUuKq1KvktEnRlQazz1xPVEfOGlkAiBJ1kIbfvjXQV0z3XihccI2vI3XQRMyj3KOPfIOk4A+sQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28454},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.8.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"20.19.2","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.5_1766822831147_0.23091712251610375","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@aisf/mcp-client","version":"1.0.6","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.6","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"mcp-client":"src/index.js","aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"4c2bc4d130c6f4d2f95307803f2a25baa3f4a081","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.6.tgz","fileCount":4,"integrity":"sha512-pyyYzUwp5rj36n1j+yIbuGLMSIFlfwODU9kFoHFisFmYUH8W7QkUH8fQlRCd5kGFTc/gsL7+5Uod/MjWH3/dEg==","signatures":[{"sig":"MEUCIQC2GCKcbpdNgIF3mXGGerEoeNvJEXcEO96bHL84spH5UwIgAfEmKsBOl1TNCKpNNBKsaH1v2qDYBj1npwjJ1LWt0g4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28568},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.8.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"20.19.2","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.6_1766823106439_0.64320702940515","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@aisf/mcp-client","version":"1.0.7","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.7","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"mcp-client":"src/index.js","aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"cbd78df856cfb5d14e0586a847ff6ae8b6bd0894","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.7.tgz","fileCount":4,"integrity":"sha512-pjyPS2s+/NenpfQ4KZIGjj3ygcdxNcRO7jrFdszUTLXxI+RG1/3+XlHY+Gr3xGTunJKxbB4dhAUVFas0dVC4jg==","signatures":[{"sig":"MEQCIHQcs2/p+t+b/3QAHjJe8HElCI31ylIZKH2nAPh8GEejAiAr/XtEyQauFF6PXiVhbJi82fSWZkLDJqwgfeKXGicExA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28568},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.8.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"20.19.2","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.7_1766823353402_0.7914974723446673","host":"s3://npm-registry-packages-npm-production"}},"1.0.8":{"name":"@aisf/mcp-client","version":"1.0.8","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","_id":"@aisf/mcp-client@1.0.8","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"homepage":"https://github.com/aisf/aisf-spec#readme","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"bin":{"mcp-client":"src/index.js","aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"dist":{"shasum":"8e20ce3eaba6bfac60dee4eef808f9279cc49390","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.8.tgz","fileCount":4,"integrity":"sha512-m+fKNFcs8P13AaF9dACMzb7t4zt6JLSLNiJkQgVrsbbMiKkZY54pGQPy8zegCQZUxW/gAhpDeQl56Bl7ylv0Ug==","signatures":[{"sig":"MEQCIDo1evojQZElqOow2EMV9n5tsALelidV32nYJipD2FdhAiAQ1nLx3qyQXIKU73SkIOnDJnBWK8ilSdzqeAGZZaE+Mg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28861},"main":"src/index.js","type":"module","engines":{"node":">=18.0.0"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:major":"./publish.sh major","publish:minor":"./publish.sh minor","publish:patch":"./publish.sh patch","prepublishOnly":"echo '准备发布...'","publish:dry-run":"./publish.sh patch --dry-run"},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"repository":{"url":"git+https://github.com/aisf/aisf-spec.git","type":"git","directory":"aisf-node-mcp-client"},"_npmVersion":"10.8.2","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","directories":{},"_nodeVersion":"20.19.2","dependencies":{"axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-client_1.0.8_1766825087988_0.07084418405329718","host":"s3://npm-registry-packages-npm-production"}},"1.0.9":{"name":"@aisf/mcp-client","version":"1.0.9","description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","main":"src/index.js","type":"module","bin":{"mcp-client":"src/index.js","aisf-mcp-client":"src/index.js","aisf-mcp-configure":"bin/configure.js"},"scripts":{"start":"node src/index.js","configure":"node bin/configure.js","publish:patch":"./publish.sh patch","publish:minor":"./publish.sh minor","publish:major":"./publish.sh major","publish:dry-run":"./publish.sh patch --dry-run","prepublishOnly":"echo '准备发布...'"},"keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","axios":"^1.6.0"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/aisf/aisf-spec.git","directory":"aisf-node-mcp-client"},"_id":"@aisf/mcp-client@1.0.9","bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"homepage":"https://github.com/aisf/aisf-spec#readme","_nodeVersion":"20.19.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-PD+8fw2KaB+oa+Pek2rVYFk0EeeaIVu5CYzFnXxXlwkCkEDKunzUiZn9B4DFqIpity2sNxNUeBdPvn+X/WmzLw==","shasum":"473b6c744543b41fea8b7a22189d72acc256e47a","tarball":"https://registry.npmjs.org/@aisf/mcp-client/-/mcp-client-1.0.9.tgz","fileCount":4,"unpackedSize":31482,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDeHeOkQ/J92a2kfZVi/ZV6zUXso8Djh2lRNZar3dr04gIgdV5RKu72Zchd9i86P4U8xC82bvYl+XGIqQpc3+oWvYk="}]},"_npmUser":{"name":"hxg","email":"hxgqh@126.com"},"directories":{},"maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-client_1.0.9_1766825558428_0.30729007736881875"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-27T02:46:40.632Z","modified":"2025-12-27T08:52:38.781Z","1.0.1":"2025-12-27T02:46:40.997Z","1.0.2":"2025-12-27T03:01:26.147Z","1.0.3":"2025-12-27T03:26:50.695Z","1.0.4":"2025-12-27T06:56:53.654Z","1.0.5":"2025-12-27T08:07:11.286Z","1.0.6":"2025-12-27T08:11:46.575Z","1.0.7":"2025-12-27T08:15:53.549Z","1.0.8":"2025-12-27T08:44:48.147Z","1.0.9":"2025-12-27T08:52:38.566Z"},"bugs":{"url":"https://github.com/aisf/aisf-spec/issues"},"license":"MIT","homepage":"https://github.com/aisf/aisf-spec#readme","keywords":["mcp","model-context-protocol","aisf","cursor","claude"],"repository":{"type":"git","url":"git+https://github.com/aisf/aisf-spec.git","directory":"aisf-node-mcp-client"},"description":"AISF MCP Client - Node.js 版本，作为 MCP Server 与 Cursor/Claude Desktop 通信","maintainers":[{"name":"hxg","email":"hxgqh@126.com"}],"readme":"# AISF MCP Client (Node.js 版本)\n\n## 概述\n\nAISF MCP Client 是本地客户端，作为 MCP Server 与 Cursor/Claude Desktop 通信，通过 REST API 调用远程服务器上的功能。\n\n这是 Node.js 版本的实现，支持通过 `npx` 进行配置。\n\n## 功能\n\n提供以下 MCP 工具接口：\n\n- **初始化项目代码仓库**：通过 REST API 在服务器上执行初始化脚本。代码在服务器上。\n- **生成前端界面**：从服务器获取模板规范流程文档，并将代码生成到本地。\n- **后端接口及前后端联调**：从服务器获取模板规范流程文档，并将代码生成到本地。\n- **配置菜单**：从服务器获取模板规范流程文档。将菜单配置的文档生成到本地并在本地完成配置菜单接口调用；\n- **自动化测试**：从服务器获取模板规范流程文档，并将测试代码生成到本地。\n- **更新代码**：将服务器上的代码拉取到本地（只有初始化之后需要用到）。\n\n## 安装\n\n**推荐使用 npx 方式（无需本地安装）**\n\n此包设计为通过 `npx` 直接运行，无需本地安装。只需确保已安装 Node.js >= 18.0.0。\n\n### 使用 npx（推荐）\n\n```bash\n# 运行配置工具\nnpx @aisf/mcp-client configure\n\n# 或直接运行 MCP client（在 Cursor/Claude Desktop 配置中使用）\nnpx @aisf/mcp-client\n```\n\n### 本地安装（可选）\n\n如果需要本地安装：\n\n```bash\ncd aisf-node-mcp-client\nnpm install\nnpm run configure\n```\n\n## 配置\n\n### 使用配置工具（推荐）\n\n运行配置工具，它会引导您完成配置并生成配置文件：\n\n```bash\nnpx @aisf/mcp-client configure\n```\n\n配置工具会：\n1. 提示您输入服务器 URL（默认：http://192.168.1.7:10190）\n2. 提示您输入本地代码路径（默认：~/codes/taobao/kaggle）\n3. 选择配置方式（npx 方式或本地路径方式）\n4. 生成 Cursor 和 Claude Desktop 的配置\n5. 可选择将配置保存到本地文件\n\n### 手动配置\n\n#### 方式一：使用 npx（推荐，无需本地安装）\n\n**Cursor 配置**\n\n在 Cursor 设置中添加 MCP Server 配置：\n\n```json\n{\n  \"aisf_mcp\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@aisf/mcp-client@latest\"],\n    \"env\": {\n      \"AISF_SERVER_URL\": \"http://192.168.1.7:10190\",\n      \"AISF_LOCAL_CODE_PATH\": \"~/codes/taobao/kaggle\"\n    }\n  },\n}\n```\n\n**Claude Desktop 配置**\n\n在 Claude Desktop 配置文件中添加：\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`  \n**Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"aisf-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aisf/mcp-client\"],\n      \"env\": {\n        \"AISF_SERVER_URL\": \"http://192.168.1.7:10190\",\n        \"AISF_LOCAL_CODE_PATH\": \"~/codes/taobao/kaggle\"\n      }\n    }\n  }\n}\n```\n\n**配置说明：**\n- `command`: 使用 `npx` 命令\n- `args`: `[\"-y\", \"@aisf/mcp-client\"]` - `-y` 表示自动确认，无需交互\n- `env.AISF_SERVER_URL`: 服务器 REST API 地址（默认：http://192.168.1.7:10190）\n- `env.AISF_LOCAL_CODE_PATH`: 本地代码保存路径（可选，默认：~/codes/taobao/kaggle）\n\n**优点：**\n- ✅ 无需本地安装包\n- ✅ 自动使用最新版本\n- ✅ 配置简单，无需管理路径\n\n#### 方式二：使用本地路径（备选方案）\n\n如果您已经本地安装了包，可以使用本地路径：\n\n**Cursor 配置：**\n\n```json\n{\n  \"aisf_mcp\": {\n    \"command\": \"node\",\n    \"args\": [\"/absolute/path/to/aisf-node-mcp-client/src/index.js\"],\n    \"env\": {\n      \"AISF_SERVER_URL\": \"http://192.168.1.7:10190\",\n      \"AISF_LOCAL_CODE_PATH\": \"~/codes/taobao/kaggle\"\n    }\n  }\n}\n```\n\n**Claude Desktop 配置：**\n\n```json\n{\n  \"mcpServers\": {\n    \"aisf-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/aisf-node-mcp-client/src/index.js\"],\n      \"env\": {\n        \"AISF_SERVER_URL\": \"http://192.168.1.7:10190\",\n        \"AISF_LOCAL_CODE_PATH\": \"~/codes/taobao/kaggle\"\n      }\n    }\n  }\n}\n```\n\n**注意**：请将 `/absolute/path/to/aisf-node-mcp-client` 替换为实际的绝对路径。\n\n配置完成后，重启 Cursor/Claude Desktop 即可使用。\n\n## 工作流程\n\n1. 用户在 Cursor/Claude 中调用 MCP 工具\n2. Client 在本地接收请求\n3. Client 通过 HTTP REST API 调用服务器\n4. 服务器执行相应的操作并返回结果\n5. Client 将结果返回给 Cursor/Claude\n\n## 环境变量\n\n- `AISF_SERVER_URL`: 服务器 REST API 地址（默认：http://192.168.1.7:10190）\n- `AISF_LOCAL_CODE_PATH`: 本地代码保存路径（可选，默认：~/codes/taobao/kaggle）\n  - 支持绝对路径和相对路径（使用 `~` 表示用户主目录）\n  - 例如：`/Users/username/projects` 或 `~/projects/mycode`\n\n## 故障排查\n\n### 无法连接到服务器\n\n检查服务器地址和端口：\n\n```bash\ncurl http://192.168.1.7:10190/\n```\n\n应该返回 API 信息。\n\n### API 请求失败\n\n检查服务器是否正常运行：\n\n```bash\ncurl http://192.168.1.7:10190/api/init-project -X POST -H \"Content-Type: application/json\" -d '{\"tech_stack\":\"JeecgBoot\",\"project_name\":\"test\"}'\n```\n\n### 代码更新失败\n\n确保本地有 Git 客户端，并且可以访问 GitLab：\n\n```bash\ngit --version\nssh -T git@gitlab.haomo-studio.com -p 15822\n```\n\n### Node.js 版本问题\n\n确保 Node.js 版本 >= 18.0.0：\n\n```bash\nnode --version\n```\n\n## 依赖\n\n- Node.js >= 18.0.0\n- @modelcontextprotocol/sdk >= 0.5.0\n- axios >= 1.6.0\n\n## 与 Python 版本的对比\n\n| 特性 | Node.js 版本 | Python 版本 |\n|------|-------------|-------------|\n| 配置方式 | npx 配置工具 + 手动配置 | 手动配置 |\n| 运行方式 | node / npx | python3 |\n| 依赖管理 | npm | pip |\n| 性能 | 良好 | 良好 |\n\n## 发布\n\n关于如何发布此包到 npm，请参阅 [发布指南](./PUBLISH.md)。\n\n## 相关文档\n\n- [服务器端部署文档](../aisf-mcp/README.md)\n- [Python 版本客户端](../aisf-mcp-client/README.md)\n- [发布指南](./PUBLISH.md)\n\n","readmeFilename":"README.md"}