Universal MCP Server

Универсальный MCP сервер с модульной архитектурой плагинов. Позволяет легко добавлять новые инструменты без изменения основного кода.

Создайте файл.envв корне проекта на основе.env.example:

# Telegram Bot Configuration TELEGRAM_BOT_TOKEN=your_bot_token_here TELEGRAM_CHAT_ID=your_chat_id_here # Server Configuration PORT=8080 # Database Configuration DATABASE_URL=postgresql://username:password@localhost:5432/timelix # Example for local development: # DATABASE_URL=postgresql://postgres:password@localhost:5432/timelix # Example for production with SSL: # DATABASE_URL=postgresql://username:password@host:5432/database?sslmode=require

Для локальной разработки используйте Docker Compose с пробросом порта:

# Запуск для разработки (с портом 8080 наружу) docker-compose -f docker-compose.local.yml up --build # Запуск в фоне docker-compose -f docker-compose.local.yml up --build -d # Остановка docker-compose -f docker-compose.local.yml down

Сервер будет доступен наhttp://localhost:8080с SSE endpoint на/sse.

Альтернативно через npm (для разработки с hot reload):

На сервере используйте обычный Docker Compose:

# На сервере - деплой в продакшн docker-compose up --build -d # Остановка docker-compose down # Обновление (пересборка) docker-compose down docker-compose up --build -d

- Модульная архитектура: добавляйте новые инструменты, просто создавая файлы в папкеsrc/tools/
- Автоматическая загрузка: система автоматически обнаруживает и регистрирует все инструменты
- TypeScript: полная типизация для безопасности и удобства разработки
- Docker поддержка: готовые Docker и Docker Compose конфигурации
- Готовые инструменты: 4 встроенных инструмента для различных задач
- Найдите бота @BotFather в Telegram
- Отправьте команду/newbot
- Следуйте инструкциям для создания бота
- Скопируйте полученный токен
- Запустите вашего бота
- Отправьте ему любое сообщение
- Перейдите по ссылке:https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
- Найдите значениеchat.idв ответе

- docker-compose.local.yml- для локальной разработки (порт 8080 наружу)
- docker-compose.yml- для продакшена (без проброса портов, с Coolify лейблами)

Отредактируйте файл конфигурации Claude Desktop:

Windows:%APPDATA%\Claude\claude_desktop_config.json
macOS:~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "Universal MCP Server": { "url": "http://localhost:8080/sse" } } }

После изменения конфигурации перезапустите Claude Desktop.

Чтобы добавить новый инструмент, создайте файл в папкеsrc/tools/следующего формата:

import { z } from 'zod' import type { ToolDefinition } from '../types/tool.js' export const toolDefinition: ToolDefinition = { name: 'myNewTool', description: 'Описание нового инструмента', inputSchema: z.object({ parameter1: z.string().describe('Описание параметра'), parameter2: z.number().optional().describe('Опциональный параметр'), }), handler: async (args) => { // Логика инструмента return { success: true, result: 'Результат работы инструмента', } }, }

Система автоматически обнаружит и зарегистрирует новый инструмент при следующем запуске сервера.

Universal-MCP-Server/ ├── src/ │ ├── tools/ # 🔧 Папка с инструментами │ │ ├── README.md # Документация для разработчиков │ │ ├── messages.ts # Telegram сообщения │ │ ├── http-requests.ts # HTTP запросы │ │ ├── file-operations.ts # Файловые операции │ │ └── database-tool.ts # SQL запросы │ ├── types/ │ │ └── tool.ts # TypeScript интерфейсы │ ├── utils/ │ │ └── tool-loader.ts # Автозагрузчик инструментов │ └── main.ts # Главный файл сервера ├── dist/ # Скомпилированные файлы ├── docker-compose.yml # Docker Compose для продакшена ├── docker-compose.local.yml # Docker Compose для локальной разработки ├── Dockerfile # Docker образ ├── .env # Переменные окружения ├── .env.example # Пример переменных окружения └── README.md # Эта документация

// Параметры: { text: string // Текст сообщения }

// Параметры: { url: string, // URL для запроса method?: "GET" | "POST" | "PUT" | "DELETE", // HTTP метод (по умолчанию GET) headers?: object, // HTTP заголовки body?: string // Тело запроса (для POST/PUT) }

// Параметры: { expression: string // Математическое выражение }

Универсальное управление блоками - полный CRUD функционал

// Параметры: { operation: "list" | "create" | "update" | "delete" | "get", // Тип операции userId: string, // ID пользователя blockId?: string, // ID блока (для get, update, delete) parentId?: string, // ID родительского блока type?: "text" | "todo" | "media" | "link" | "container" | "unit_ref" | "calendar" | "database", // Тип блока title?: string, // Заголовок блока content?: object, // Содержимое блока (JSON) style?: object, // Стили блока (JSON) position?: object, // Позиция блока (JSON) order?: number, // Порядок блока archived?: boolean, // Архивирован ли блок tags?: any[] // Теги блока }

// Параметры: { title: string, // Название задачи (обязательно) description?: string, // Описание задачи priority?: "high" | "medium" | "low", // Приоритет задачи dueDate?: string, // Срок выполнения (ISO строка) tags?: string[], // Теги задачи projectId?: string // ID проекта }

Читать задачи (тудушки) - по ID, позиции, поиску или список всех

// Параметры: { todoId?: string, // Точный ID задачи (если известен) position?: number, // Номер задачи в списке (1, 2, 3...) titleSearch?: string // Поиск по части названия задачи }

// Параметры: { // Поиск задачи для обновления (один из параметров): todoId?: string, // Точный ID задачи position?: number, // Номер задачи в списке titleSearch?: string, // Поиск по части названия // Поля для обновления: title?: string, // Новое название задачи description?: string, // Новое описание задачи completed?: boolean, // Новый статус выполнения priority?: "high" | "medium" | "low", // Новый приоритет dueDate?: string, // Новый срок выполнения tags?: string[], // Новые теги задачи projectId?: string // Новый ID проекта }

Удалить задачу (тудушку) - мягкое удаление

// Параметры: { todoId?: string, // Точный ID задачи (если известен) position?: number, // Номер задачи в списке (1, 2, 3...) titleSearch?: string // Поиск по части названия задачи }

Универсальное управление агентами (ИИ ассистенты) - полный CRUD функционал

// Параметры: { operation: "list" | "create" | "update" | "delete" | "get", // Тип операции userId: string, // ID пользователя unitId?: string, // ID агента (для get, update, delete) name?: string, // Имя агента description?: string, // Описание агента avatar?: string, // Аватар агента model?: string, // Модель ИИ (например, gpt-4, claude-3) systemPrompt?: string, // Системный промпт агента tools?: any[], // Инструменты агента isDefault?: boolean, // Агент по умолчанию avatarUrl?: string, // URL аватара агента unitType?: "assistant" | "human" | "timelix" | "system", // Тип агента nameSearch?: string // Поиск по части имени агента }

- ES Modules: современная модульная система JavaScript
- TypeScript: полная типизация с компиляцией в ES2020
- Express.js: HTTP сервер для MCP протокола
- Server-Sent Events (SSE): для MCP коммуникации
- Zod: валидация схем для безопасности типов
- Автоматическая загрузка: переменные окружения через dotenv

Проект включает готовые Docker конфигурации:

- Dockerfile- образ для сборки приложения
- docker-compose.yml- для продакшен деплоя (без проброса портов)
- docker-compose.local.yml- для локальной разработки (с портом 8080 наружу)

docker-compose -f docker-compose.local.yml up --build -d

- Форкните репозиторий
- Создайте ветку для новой функции
- Добавьте свои инструменты вsrc/tools/
- Протестируйте изменения
- Создайте Pull Request

MIT License. Смотрите файл LICENSE для деталей.

Создано с ❤️ для упрощения работы с MCP инструментами

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

The MCP server for Bitrix24 provides AI assistants with structured access to the Bitrix24 API. It delivers up-to-date method descriptions, parameters, and valid values, allowing assistants to work with precise data instead of guesswork. This reduces code errors and accelerates Bitrix24 integration development.

One remote MCP server for 500+ production APIs — Stripe, HubSpot, Postgres, Gmail, and more. OAuth and API key auth, credential management, and a CLI.

Single tool to control all 100+ API integrations, and UI components

Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.

Self-hosted MCP gateway: convert REST/SOAP/GraphQL/SQL APIs into MCP tools with 29 pre-built adapters, OAuth2, RBAC and audit log.

A universal bridge to convert any web API into an MCP server, supporting multiple transport types.

Dynamically creates MCP servers from web API configurations, integrating any REST API, GraphQL endpoint, or web service into MCP-compatible tools.

Hosted MCP server and coordination layer for AI coding agents — live API contracts, database schema, frontend/backend mismatch detection, and shared handoff tickets for Claude Code, Cursor, Codex, and Lovable.

An MCP server that dynamically loads tools from an external JSON file configured via an environment variable.

A lightweight server exposing Axone's capabilities through the Model-Context Protocol.