开始使用 AnythingMCP

什么是 AnythingMCP？

AnythingMCP 是一个开源网关，将你的 REST、SOAP、GraphQL API 和数据库转换为 MCP（模型上下文协议）服务器。一旦连接，你可以通过 Claude、ChatGPT、Copilot 或任何兼容 MCP 的客户端与你的系统进行交互。

先决条件

• Docker 和 Docker Compose — 安装 Docker
• Git — 用于克隆代码库
• 终端 — macOS 或 Linux 上的 bash

如果不使用 Docker 进行本地开发（可选）：

• Node.js 22+
• npm

快速开始

1. 克隆代码库

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

2. 运行设置脚本

bash setup.sh

交互式向导将引导你完成完整配置：

步骤 1 — 部署模式 选择 Docker（推荐用于生产）或本地开发。

步骤 2 — 域名和端口 输入你的主机名。对于本地使用，请保持默认的 localhost。对于生产，请输入你的域名（例如 mcp.example.com），脚本将配置 Caddy 作为反向代理，并自动获取 Let's Encrypt SSL。

步骤 3 — 秘密 所有安全凭证将自动生成：

• 用于身份验证的 JWT 秘密
• 用于敏感数据的加密密钥
• 数据库密码
• NextAuth 秘密

步骤 4 — MCP 身份验证 选择 AI 代理如何与你的 MCP 端点进行身份验证：

• OAuth 2.0（推荐）
• API 密钥 / Bearer Token（遗留）
• 两者（OAuth + 遗留回退）
• 无（仅限开发）

步骤 5 — 电子邮件（可选） 配置 SMTP 以进行用户验证、邀请和密码重置。

步骤 6 — Redis（可选） 启用 Redis 以进行速率限制和响应缓存。

脚本生成 .env 文件，配置 Docker Compose，并自动启动所有服务。

3. 打开仪表板

设置完成后，打开仪表板：

• 本地： http://localhost:3000
• 使用域名： https://mcp.example.com

注册你的管理员账户 — 第一个注册的用户将成为管理员。

连接你的第一个 API

1. 登录仪表板
2. 点击 创建连接器
3. 选择你的连接器类型（REST、SOAP、GraphQL 或数据库）
4. 配置连接（导入 OpenAPI 规范、WSDL，或输入数据库凭证）
5. 保存并激活

你的 MCP 端点已准备好，地址为：

http://localhost:4000/mcp

连接 AI 代理

将你的 MCP 服务器添加到任何兼容的 AI 客户端。Claude Desktop 的示例（或直接在 Claude.ai → 连接器 中添加你的服务器 URL）：

{
  "mcpServers": {
    "my-server": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

架构

AnythingMCP 作为一个单一容器运行，包含两个服务：

附加服务：

• PostgreSQL 17 — 存储连接器、用户和配置
• Caddy（可选） — 带自动 SSL 的反向代理
• Redis（可选） — 速率限制和响应缓存

常用命令

# 查看日志
docker compose logs -f

# 重启服务
docker compose restart

# 停止服务
docker compose down

# 更新到最新版本
git pull && docker compose up -d --build

下一步

• 什么是 MCP？ — 了解模型上下文协议
• REST API 到 MCP — 连接你的第一个 REST API
• 数据库到 MCP — 直接连接数据库
• 在 Hetzner 上部署 — 带 SSL 的生产部署
• 在 AWS 上部署 — 在 EC2 上部署