Summary
使用AnythingMCP将传统的SOAP/WSDL网络服务转换为现代MCP服务器。将企业SOAP API与AI代理连接,而无需重写任何内容。
为什么SOAP API仍然重要
尽管REST和GraphQL的兴起,SOAP网络服务仍然是企业IT的支柱。银行、保险公司、医疗服务提供商和政府机构依赖数百万个SOAP端点来支持关键的业务流程。
问题是什么?AI代理使用的是MCP,而不是SOAP。直到现在,将AI连接到这些遗留系统需要定制中间件、数月的开发时间和深厚的SOAP专业知识。
AnythingMCP:几分钟内实现SOAP到MCP的转换
AnythingMCP自动解析WSDL定义,将SOAP操作映射到MCP工具,并在后台处理所有XML序列化和反序列化。
分步指南
第一步:部署AnythingMCP
克隆代码库并使用Docker Compose启动应用程序:
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
这将启动PostgreSQL、后端API(端口4000)和仪表板(端口3000)。
第二步:创建SOAP连接器
在http://localhost:3000打开AnythingMCP仪表板并创建一个新的SOAP连接器。提供你的服务的WSDL URL — AnythingMCP将自动解析它并发现所有可用的操作。
第三步:自动WSDL解析
AnythingMCP读取你的WSDL并自动:
- 发现所有SOAP操作(例如,
getOrder、createInvoice、updateCustomer) - 将复杂的XML类型映射到结构化的MCP工具参数
- 为AI代理生成可读性强的描述
- 透明地处理SOAP信封、头部和命名空间
第四步:配置身份验证
在连接器设置中,为你的SOAP服务配置身份验证。AnythingMCP支持WS-Security、基本身份验证和自定义SOAP头。可以使用环境变量安全存储凭据。
第五步:自定义工具映射
在仪表板中,查看要公开的操作并自定义它们在AI代理中的显示方式。你可以重命名工具、改善描述,并排除危险操作。
第六步:测试和连接
使用内置测试界面直接从仪表板调用每个SOAP操作。然后配置你的MCP客户端:
{
"mcpServers": {
"my-soap-service": {
"url": "http://localhost:4000/mcp"
}
}
}
常见企业SOAP用例
| SOAP服务 | 生成的MCP工具 | AI代理用例 |
|---|---|---|
| SAP RFC/BAPI | get_material_details | "查找零件X的库存" |
| Oracle EBS | create_purchase_order | "为100个单位创建采购订单" |
| 医疗保健HL7 | get_patient_record | "检索患者历史" |
| 银行核心 | get_account_balance | "检查账户状态" |
| 保险索赔 | submit_claim | "提交新的保险索赔" |
处理复杂的XML类型
SOAP API通常使用深度嵌套的XML结构。AnythingMCP将这些结构扁平化为AI代理可以轻松处理的直观JSON参数。
最佳实践
- 先只读 — 首先公开查询操作,然后添加写入操作
- 使用WS-Security — 切勿以明文传递凭据
- 使用你的WSDL进行测试 — 验证WSDL是否可以从AnythingMCP服务器访问
- 速率限制 — SOAP服务通常有严格的速率限制;请相应配置
下一步
- REST到MCP指南 — 转换REST API
- SAP到MCP指南 — 专门连接SAP系统
这份指南对你有帮助吗?