MCP Framework и MCP Серверы

Monorepo с MCP Framework пакетами и MCP серверами для различных сервисов

Этот репозиторий содержит:

• MCP Серверы — готовые серверы для Yandex Tracker, Yandex Wiki, TickTick
• MCP Framework — переиспользуемые пакеты для создания MCP инструментов

---

📦 Скачать MCPB Bundles

Готовые бандлы для установки в MCP клиенты (Claude Desktop и др.):

Сервер	Описание	Скачать
Yandex Tracker	Интеграция с Yandex.Tracker API	⬇️ mcp-server-yandex-tracker.mcpb
Yandex Wiki	Интеграция с Yandex Wiki API	⬇️ mcp-server-yandex-wiki.mcpb
TickTick	Интеграция с TickTick API	⬇️ mcp-server-ticktick.mcpb

💡 Все бандлы также доступны на странице GitHub Releases

---

Быстрый старт (Пользователи)

Способ 1: MCPB Bundle (Рекомендуется для Claude Desktop)

Скачай готовый .mcpb бандл по ссылкам выше и установи его напрямую в Claude Desktop.

⚠️ MCPB формат пока поддерживается только Claude Desktop

Способ 2: npm установка

# Установи нужный сервер глобально
npm install -g @fractalizer/mcp-server-yandex-tracker  # Yandex Tracker
npm install -g @fractalizer/mcp-server-yandex-wiki     # Yandex Wiki
npm install -g @fractalizer/mcp-server-ticktick        # TickTick

# Запусти интерактивную настройку
mcp-tracker-connect connect
mcp-wiki-connect connect
mcp-ticktick-connect connect

CLI проведёт через настройку и автоматически добавит сервер в конфигурацию выбранного клиента.

Поддерживаемые клиенты: Claude Desktop, Claude Code, Codex, Gemini, Qwen

Ручная настройка — см. README соответствующего пакета в разделе Пакеты.

💡 Нет Node.js? Установи через fnm (рекомендуется) или nodejs.org

---

Пакеты

MCP Серверы

Пакет	Описание
@fractalizer/mcp-server-yandex-tracker	MCP сервер для Yandex.Tracker API (v2/v3)
@fractalizer/mcp-server-yandex-wiki	MCP сервер для Yandex Wiki API
@fractalizer/mcp-server-ticktick	MCP сервер для TickTick API

Framework пакеты

Пакет	Описание
@fractalizer/mcp-infrastructure	HTTP клиент, кэш, логирование, async утилиты
@fractalizer/mcp-cli	Универсальный CLI для MCP подключений
@fractalizer/mcp-core	Базовые классы, система типов, реестр инструментов
@fractalizer/mcp-search	Поисковый движок с compile-time индексацией

---

Архитектура

packages/
├── framework/
│   ├── infrastructure/     → @fractalizer/mcp-infrastructure
│   ├── cli/               → @fractalizer/mcp-cli
│   ├── core/              → @fractalizer/mcp-core
│   └── search/            → @fractalizer/mcp-search
└── servers/
    ├── yandex-tracker/    → @fractalizer/mcp-server-yandex-tracker
    ├── yandex-wiki/       → @fractalizer/mcp-server-yandex-wiki
    └── ticktick/          → @fractalizer/mcp-server-ticktick

Граф зависимостей:

infrastructure (0 зависимостей)
    ↓
cli (зависит от infrastructure)
    ↓
core (зависит от infrastructure)
    ↓
search (зависит от core)
    ↓
yandex-tracker (зависит от всех framework пакетов)

Подробности: ARCHITECTURE.md

---

Разработка

Для контрибьюторов

# Клонируй и настрой
git clone https://github.com/FractalizeR/mcp_servers.git
cd mcp_servers
npm install
npm run build
npm run test

Читай руководство: .github/CONTRIBUTING.md

Для пользователей Framework

npm install @fractalizer/mcp-infrastructure
npm install @fractalizer/mcp-core
npm install @fractalizer/mcp-search

Примеры использования: см. README.md в каждом пакете.

Команды Workspace

# Установить все зависимости
npm install

# Собрать все пакеты (топологический порядок)
npm run build

# Протестировать все пакеты
npm run test

# Валидация всего monorepo
npm run validate

# Очистить все пакеты
npm run clean

Работа с отдельными пакетами

# Собрать один пакет
npm run build --workspace=@fractalizer/mcp-core

# Протестировать один пакет
npm run test --workspace=mcp-server-yandex-tracker

# Все команды пакета
cd packages/servers/yandex-tracker
npm run <script>

Управление зависимостями

# Добавить зависимость в конкретный пакет
npm install axios --workspace=@fractalizer/mcp-infrastructure

# Добавить framework пакет в yandex-tracker
cd packages/servers/yandex-tracker
npm install @fractalizer/mcp-core

---

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

Monorepo

• CLAUDE.md — руководство для ИИ агентов
• ARCHITECTURE.md — обзор архитектуры
• .github/CONTRIBUTING.md — руководство для контрибьюторов

Пакеты

• Infrastructure: packages/framework/infrastructure/README.md
• CLI: packages/framework/cli/README.md
• Core: packages/framework/core/README.md
• Search: packages/framework/search/README.md
• Yandex Tracker: packages/servers/yandex-tracker/README.md

---

Тестирование

Запустить все тесты:

npm run test

С покрытием:

npm run test:coverage

Для конкретного пакета:

npm run test --workspace=@fractalizer/mcp-core

Watch режим:

cd packages/servers/yandex-tracker
npm run test:watch

---

Качество кода

Линтинг:

npm run lint              # Проверить все пакеты
npm run lint:fix          # Исправить автоматически

Проверка типов:

npm run typecheck         # Проверить все пакеты

Валидация архитектуры:

npm run depcruise         # Валидация графа зависимостей
npm run depcruise:graph   # Сгенерировать визуальный граф

Аудит безопасности:

npm run audit:socket      # Анализ supply-chain
npm run audit:secrets     # Сканирование секретов
npm run audit:lockfile    # Проверка package-lock.json

Поиск мертвого кода:

npm run knip              # Найти неиспользуемые файлы/экспорты/зависимости

---

Публикация

Framework пакеты (@fractalizer/mcp-*) публикуются в npm registry. Серверные пакеты (@fractalizer/mcp-server-*) публикуются в npm registry.

Управление версиями:

• Используется Changesets
• Автоматизировано через GitHub Actions при merge в main

Ручная публикация (при необходимости):

# Создать changeset
npx changeset add

# Обновить версии
npx changeset version

# Опубликовать (из main ветки)
npm publish --workspaces

---

Вклад в проект

Мы приветствуем вклад в проект! Пожалуйста, прочитай:

1. .github/CONTRIBUTING.md — процесс контрибьюции
2. CLAUDE.md — соглашения о коде и правила архитектуры
3. ARCHITECTURE.md — понимание кодовой базы

Быстрый чек-лист:

• Форкни и создай feature ветку
• Следуй соглашениям о коде (см. CLAUDE.md)
• Добавь тесты (покрытие ≥80%)
• Запусти npm run validate перед коммитом
• Напиши понятные сообщения коммитов
• Открой Pull Request

---

Лицензия

PolyForm Shield License 1.0.0 — свободное использование, модификация и распространение, за исключением создания конкурирующих продуктов.

См. LICENSE для подробностей.

---

Ссылки

• GitHub: https://github.com/FractalizeR/mcp_servers
• Releases: https://github.com/FractalizeR/mcp_servers/releases
• Issues: https://github.com/FractalizeR/mcp_servers/issues
• MCP спецификация: https://github.com/anthropics/mcp
• Yandex.Tracker API: https://cloud.yandex.ru/docs/tracker/about-api

---

Поддержка

Нашел баг или есть вопрос?

1. Проверь issues
2. Прочитай документацию пакетов (README.md в каждом пакете)
3. Создай новый issue с подробностями

Хочешь помочь?

• Поставь звезду на GitHub
• Сообщи о баге
• Предложи новую фичу
• Сделай Pull Request

---