Nexus-MCP

Комплексный инструментарий протокола контекста модели (MCP) для ИИ-ассистентов

Превратите любого ИИ-ассистента в автономного агента, способного выполнять реальные задачи.

Документация • Начало работы • Дорожная карта • Архитектура

🎯 Обзор

Nexus-MCP — это мощный сервер протокола контекста модели (MCP), созданный на TypeScript/Node.js, который предоставляет ИИ-моделям универсальные инструменты для:

• 📁 Операций с файловой системой — чтение, запись, поиск и мониторинг файлов

• 🌐 HTTP/веб-запросов — получение данных, парсинг веб-сайтов, вызов API

• 🔄 Рабочих процессов Git — клонирование, коммиты, ветки и управление репозиториями

• 🗄️ Запросов к базам данных — выполнение SQL и NoSQL запросов

• 💻 Системных команд — выполнение команд оболочки и управление процессами

• 🤖 Интеграции с ИИ — общение с LLM, создание эмбеддингов, обработка текста

• 🔧 Утилит — парсинг JSON/YAML, сжатие, шифрование и многое другое

🚀 Быстрый старт

Установка

npm install -g @nexus-mcp/server

Конфигурация

# Copy example environment file
cp .env.example .env

# Edit with your settings
nano .env

Запуск

nexus-mcp

Интеграция с Claude Code

Добавьте в конфигурацию Claude Desktop:

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "node",
      "args": ["/path/to/nexus-mcp/dist/index.js"]
    }
  }
}

📦 Возможности

Инструменты файловой системы

• nexus_read_file — чтение файлов с поддержкой кодировки

• nexus_write_file — запись/создание файлов

• nexus_list_directory — просмотр содержимого директории

• nexus_search_files — поиск файлов по шаблону

• nexus_search_content — поиск содержимого внутри файлов

• nexus_watch_directory — мониторинг изменений в директории

HTTP-инструменты

• nexus_http_get — HTTP GET-запросы

• nexus_http_post — HTTP POST-запросы

• nexus_fetch_url — получение и парсинг веб-контента

• nexus_parse_html — парсинг HTML с помощью Cheerio

• nexus_call_api — общие вызовы API

Инструменты Git

• nexus_git_clone — клонирование репозиториев

• nexus_git_commit — создание коммитов

• nexus_git_push — отправка в удаленный репозиторий

• nexus_git_pr_create — создание pull-реквестов

• Интеграция с GitHub, GitLab, Bitbucket

Инструменты баз данных

• nexus_db_query — выполнение SQL-запросов

• nexus_db_list_tables — список таблиц базы данных

• nexus_db_describe_table — описание схемы таблицы

• Поддержка PostgreSQL, MySQL, SQLite, SQL Server, MongoDB

Системные инструменты

• nexus_exec_command — выполнение команд оболочки

• nexus_system_info — получение системной информации

• nexus_process_list — список запущенных процессов

• nexus_service_start/stop — управление службами

Инструменты ИИ

• nexus_llm_chat — общение с LLM (Anthropic, OpenAI)

• nexus_embedding_create — создание текстовых эмбеддингов

• nexus_text_summarize — суммаризация текста

• nexus_code_generate — генерация кода

Инструменты-утилиты

• nexus_json_parse/stringify — манипуляции с JSON

• nexus_yaml_parse/stringify — манипуляции с YAML

• nexus_zip_create/extract — ZIP-сжатие

• nexus_encrypt/decrypt — шифрование/дешифрование

🏗️ Архитектура

┌─────────────────────────────────────────┐
│         Claude / LLM Client              │
└──────────────┬──────────────────────────┘
               │ MCP Protocol (stdio)
               ▼
┌─────────────────────────────────────────┐
│           Nexus-MCP Server               │
│  ┌───────────────────────────────────┐  │
│  │      MCP Server Core             │  │
│  └───────────────────────────────────┘  │
│         ┌───────┴───────┐                │
│         │               │                │
│    ┌────▼────┐    ┌────▼────┐           │
│    │ Filesys │    │   HTTP  │           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │   Git   │    │ Database│           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │  System │    │    AI   │           │
│    └─────────┘    └─────────┘           │
└─────────────────────────────────────────┘

Подробную информацию об архитектуре см. в docs/architecture.md

🏛️ Качество промышленного уровня

Nexus-MCP создан с учетом архитектурного совершенства, предназначен для промышленного использования и внедрения сообществом. Мы следуем строгим принципам:

• ✅ Типобезопасность: строгий режим TypeScript + валидация Zod

• ✅ Обработка ошибок: структурированные, понятные сообщения об ошибках

• ✅ Производительность: асинхронные операции, кэширование, потоковая передача

• ✅ Безопасность: валидация входных данных, санитайзинг, журналы аудита

• ✅ Наблюдаемость: структурированное логирование, метрики, трассировка

• ✅ Тестируемость: покрытие 80%+, внедрение зависимостей

• ✅ Документация: JSDoc, примеры, исчерпывающие руководства

• ✅ Опыт разработчика: понятные ошибки, поддержка IDE, быстрая обратная связь

Подробности см. в Архитектурных принципах.

📚 Документация

• Руководство по началу работы — быстрый старт и базовое использование

• Документация по архитектуре — системная архитектура и дизайн

• Архитектурные принципы — принципы проектирования и лучшие практики

• Справочник API — полная документация API

• Справочник инструментов — подробная документация по инструментам

• Дорожная карта — план разработки и прогресс

🛠️ Разработка

# Clone repository
git clone https://github.com/your-org/Nexus-MCP.git
cd Nexus-MCP

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Lint code
npm run lint

📊 Статус проекта

• Текущая версия: 1.0.0-alpha

• Статус разработки: Планирование и проектирование

• Прогресс ядра: 0%

• Целевое количество инструментов: 50+

• Цель покрытия тестами: 80%+

Подробный прогресс см. в ROADMAP.md.

🤝 Участие в разработке

Мы приветствуем вклад в проект! Пожалуйста, ознакомьтесь с нашими правилами участия перед отправкой PR.

1. Сделайте форк репозитория

2. Создайте ветку для вашей функции (git checkout -b feature/amazing-feature)

3. Зафиксируйте изменения (git commit -m 'Add amazing feature')

4. Отправьте изменения в ветку (git push origin feature/amazing-feature)

5. Откройте Pull Request

📄 Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

🙏 Благодарности

• Model Context Protocol

• Anthropic Claude

• MCP SDK TypeScript

📞 Поддержка

• 📖 Документация

• 🐛 Трекер задач

• 💬 Сообщество в Discord

• ✉️ Email: support@nexus-mcp.dev

Создано с ❤️ командой Nexus