HelpCode-ai/anythingmcp · 上手攻略

  • 仓库：HelpCode-ai/anythingmcp
  • 链接：https://github.com/HelpCode-ai/anythingmcp
  • 分类：agent · llm-infra · mcp
  • 作者：Tom
  • 更新：2026-10-21

§0 速览

项目 内容
是什么 开源自托管 MCP Gateway，将任意 REST/OpenAPI、GraphQL、SOAP、OData、SQL API 转为 MCP Tools
连接器数量 517 个预制连接器，暴露 2400+ Tools（截至 2026-10-20）
部署方式 Docker 24+（单文件 docker-compose 起动）
许可 AGPL-3.0
最新提交 2026-10-19
Stars 759
云托管 有（cloud.anythingmcp.com，7 天免费试用）
MCP 端点 http://localhost:4000/mcp（默认本地）

⚠️ 版本号浮动说明：卡片记录 508 个连接器，README 实际为 517 个，以 README 为准；arm64（Apple Silicon）镜像通过 emulation 运行，amd64 为主流。

§1 是什么 / 解决什么问题

企业里通常没有现成的 MCP Server，却有一堆 REST API、ERP 系统（SAP、Odoo）、SOAP 服务（2009 年遗老）和数据库。每个系统都要单独接入 AI agent，需要写适配层、认证逻辑、工具暴露——工程量巨大。

AnythingMCP 的思路是：不做 Agent，直接做 Gateway。它把任何有 API 规范的系统和 AI 客户端之间的鸿沟填平：

  • 任何 REST / OpenAPI / SOAP / GraphQL / OData / SQL → 直接导入 → 变成 MCP Tools
  • 517 个预制连接器（SAP、 DHL、Etsy、WooCommerce、Personio……）→ 开箱即配，不用写代码
  • 企业级能力：RBAC 角色权限、SSO 单点登录、审计日志、知识图谱

MCP 端点暴露后，Claude Desktop、ChatGPT、Copilot、Cursor、Gemini 均可直接接入，一个 URL 全部搞定。

§2 快速安装（docker-compose）

前提

  • Docker 24.0.0 或更新
  • 已安装 openssl（生成随机密钥用）
  • macOS：先启动 Docker Desktop

一行启动

mkdir -p anythingmcp && cd anythingmcp
curl -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' \
  "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

约 24 秒后 API 就绪。

⚠️ 密钥丢失 = 连接器全部重配：生成的 ENCRYPTION_KEY 用于加密存储的凭证；丢失后所有已配置的 API 密钥无法恢复，必须重新填入。

启动后访问

服务 地址
管理界面 http://localhost:3000
API 文档 http://localhost:4000/api/docs
MCP 端点 http://localhost:4000/mcp

首个注册账户自动成为管理员。

进阶：公网暴露（TLS + 域名）

quickstart 默认绑定 127.0.0.1（无 TLS）。如需公网访问：

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && ./setup.sh

setup.sh 会询问域名，通过 Caddy 自动申请 Let's Encrypt 证书并设置 MCP 认证模式。

其他部署方式

  • Railway：https://railway.com/deploy/8-X4WD
  • DigitalOcean App Platform：市场搜索 "anythingmcp"
  • 云托管：cloud.anythingmcp.com（法兰克福，AGPL 同款代码）

§3 核心用法

3.1 添加一个连接器

  1. 打开 http://localhost:3000 → 以管理员账户登录
  2. 点击 Add a connector
  3. 从目录选择一个预制连接器（如 SAP Business One / WooCommerce / DHL），填入 API 密钥
  4. 或上传自己的 OpenAPI spec / WSDL / GraphQL introspection / Postman collection / SQL 数据库连接
  5. 配置操作范围、字段过滤、角色权限
  6. Save → 该连接器的每个操作自动变成一个 MCP Tool

3.2 配置 AI 客户端接入 MCP

以 Claude Desktop 为例，在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "anythingmcp": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-client-cli",
               "http://localhost:4000/mcp"]
    }
  }
}

其他 AI 客户端（ChatGPT / Copilot / Cursor / Gemini）接入方式略有不同，参考 https://anythingmcp.com/guides

3.3 工具过滤与 RBAC

在管理界面可对每个连接器做：

  • 重命名 + 描述：让 AI 看到的工具名更友好
  • 字段过滤：敏感字段（如内部价格字段）可设"不出网络"
  • 角色权限：指定哪些角色（role）可以调用哪些工具

⚠️ 工具变更无需重启：连接器和工具在运行时注册，AI 侧无需重启即可看到新工具。

§4 支持的 API 类型与连接器清单

源类型 导入方式 说明
REST / OpenAPI / Swagger URL 或粘贴 spec 每个 operation → 一个 Tool，含参数/认证/端点映射
Postman Collection 上传 JSON 文件夹结构、认证、body 模式、{{variables}} 均保留
SOAP / WSDL URL 或上传 信封格式、参数顺序、WCF 服务自动处理
GraphQL introspection 或手动定义 查询和 mutation 均变为 Tool
OData（SAP Gateway 等） 元数据 URL 模型看到实体集、主键、SAP 业务标签；支持 V2 和 V4
SQL（PostgreSQL/MySQL/SQL Server/Oracle/SAP HANA/MongoDB） 数据库连接 Schema + 示例 + 查询 Tool；默认只读
另一个 MCP Server URL 发现其工具，在同一 auth + 审计下透传
517 预制连接器 目录选择 SAP / Odoo / DHL / Etsy / WooCommerce / Personio 等

§5 典型适用场景

场景 AnythingMCP 能做什么
企业 AI 助手接入内部 SAP 直接用 SAP S/4HANA OData 连接器，让 AI 查库存、跑报表
多系统联动 一次配置 Etsy 订单 + DHL 物流 + SAP 库存，AI 跨系统协调
老旧 SOAP 系统接入 AI 无需重写，用 WSDL 导入直接暴露为 Tool
数据库自然语言查询 SQL 连接器让 AI 用自然语言查 PostgreSQL/MySQL
MCP 工具聚合 把多个 MCP Server 统一到同一 Gateway 下，统一鉴权审计

§6 坑与注意

坑 说明 处理方式
Docker 24+ 必须 旧版 Docker 不支持某些新特性 docker --version 确认后再继续
Apple Silicon 需 emulation 官方镜像目前仅 amd64，Apple Silicon 走 emulation 慢约 30 秒启动，属正常现象
quickstart 无 TLS 绑定 127.0.0.1，无 Let's Encrypt 公网访问必须走 ./setup.sh 配置 Caddy TLS
ENCRYPTION_KEY 丢失 密钥丢失后所有连接器凭证不可解密 妥善保管 .env 文件
SSO/SCIM 仅自托管支持 云托管不提供 SSO/SCIM 如需企业 SSO，务必自托管
部分连接器需要 API Key 517 个中约 23 个无需 Key（23 个免费连接器） 在目录筛选"无需 API Key"
MCP 认证模式默认关闭 quickstart 的 MCP 端点无认证 公网暴露前务必通过 ./setup.sh 开启认证
删库风险 初次运行会清空 SQLite？ ⚠️ 官方未明确数据持久化路径，首次运行前建议备份

§7 与同类对比

方案 连接器数量 自托管 企业能力（RBAC/SSO） MCP 原生 许可
AnythingMCP 517（预制） ✅ ✅ RBAC / SSO / 审计日志 ✅ AGPL-3.0
MCP Hub 少量官方 ✅ ❌ ✅ Apache-2.0
SAP Integration Suite MCP 仅 SAP ❌（仅云托管） ✅ ✅ 商业授权
n8n + MCP Plugin 300+（workflow） ✅ ⚠️ 需企业版 ⚠️ 插件 AGPL-3.0
Dify 有限 ✅ ⚠️ ⚠️ Apache-2.0

AnythingMCP 的核心优势是连接器数量（517）和企业级 RBAC/SSO 开源方案，特别适合需要快速把 ERP/电商/物流接入 AI 的团队。

§8 一句话推荐结论

企业 AI 化最后一公里的最短路径：有 API 规范就能接，一个 URL 全公司 AI 共享；517 个预制连接器是最大亮点。

⚠️ 本文档不确定之处：

  • ENCRYPTION_KEY 具体加密算法未在文档中披露，仅说明"失去后凭证无法解密"，建议生产环境做好密钥备份流程。
  • 云托管版本（cloud.anythingmcp.com）与开源自托管版本的 SLA / 数据处理协议（DPA）详情需邮件联系 info@helpcode.ai 确认。
  • 517 个连接器的"Verified live"标注标准不一（SAP HANA 经实测，其他按文档），具体哪些经实际 API 验证需逐个查阅 anythingmcp.com/guides。