Начало работы с AnythingMCP

Summary

Установи и настрой AnythingMCP за считанные минуты. Клонируйте репозиторий, запусти интерактивный скрипт настройки и начни подключать твои API к AI-агентам.

Что такое AnythingMCP?

AnythingMCP — это открытый шлюз, который превращает твои REST, SOAP, GraphQL API и базы данных в серверы MCP (Model Context Protocol). После подключения ты можешь взаимодействовать с твоими системами через AI-агентов, таких как Claude, ChatGPT, Copilot или любого клиента, совместимого с MCP.

Предварительные требования

Docker и Docker Compose — Установи Docker
Git — для клонирования репозитория
Терминал — bash на macOS или Linux

Для локальной разработки без 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 как обратный прокси с автоматическим SSL от Let's Encrypt.

Шаг 3 — Секреты
Все учетные данные безопасности генерируются автоматически:

JWT секрет для аутентификации
Ключ шифрования для конфиденциальных данных
Пароль базы данных
Секрет NextAuth

Шаг 4 — Аутентификация MCP
Выбери, как AI-агенты аутентифицируются с твоим MCP-эндпоинтом:

OAuth 2.0 (рекомендуется)
API Key / Bearer Token (устаревший)
Оба (OAuth + устаревший резерв)
Нет (только для разработки)

Шаг 5 — Email (по желанию)
Настрой SMTP для подтверждения пользователей, приглашений и сброса пароля.

Шаг 6 — Redis (по желанию)
Включи Redis для ограничения скорости и кэширования ответов.

Скрипт генерирует файл .env, настраивает Docker Compose и автоматически запускает все сервисы.

3. Открой панель управления

После завершения настройки открой панель управления:

Локально: http://localhost:3000
С доменом: https://mcp.example.com

Зарегистрируйте свою учетную запись администратора — первый пользователь, который зарегистрируется, становится администратором.

Подключи твой первый API

Войди в панель управления
Нажми Создать коннектор
Выбери тип твоего коннектора (REST, SOAP, GraphQL или База данных)
Настрой соединение (импортируй спецификацию OpenAPI, WSDL или введи учетные данные базы данных)
Сохрани и активируй

Твой MCP-эндпоинт готов по адресу:

http://localhost:4000/mcp

Подключи AI-агента

Добавь твой MCP-сервер в любой совместимый AI-клиент. Пример для Claude Desktop (или добавь URL твоего сервера напрямую в Claude.ai → Коннекторы):

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

Архитектура

AnythingMCP работает как один контейнер с двумя сервисами:

Сервис	Порт	Описание
Backend (NestJS)	4000	API, MCP-эндпоинт, OAuth-сервер
Frontend (Next.js)	3000	Веб-панель управления

Дополнительные сервисы:

PostgreSQL 17 — хранит коннекторы, пользователей и конфигурацию
Caddy (по желанию) — обратный прокси с автоматическим SSL
Redis (по желанию) — ограничение скорости и кэширование ответов

Общие команды

# Просмотр логов
docker compose logs -f

# Перезапуск сервисов
docker compose restart

# Остановка сервисов
docker compose down

# Обновление до последней версии
git pull && docker compose up -d --build

Следующие шаги

Что такое MCP? — Пойми Model Context Protocol
REST API к MCP — Подключи твой первый REST API
База данных к MCP — Подключи базы данных напрямую
Развертывание на Hetzner — Развертывание в продакшене с SSL
Развертывание на AWS — Развертывание на EC2

Это руководство помогло?