LazyBearWorks/AGENTS.md

AGENTS.md

Описание проекта: LazyBear MCP

Назначение

.NET 10 сервер Model Context Protocol (MCP) для интеграции торговых AI-инструментов.

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

LazyBearWorks/
├── LazyBear.MCP/
│   ├── Program.cs              # Главный файл с хостингом MCP сервера
│   ├── Pages/                  # Razor Pages (UI)
│   ├── Services/
│   │   └── TradingTools.cs     # Реализация инструментов MCP
│   ├── appsettings.json        # Конфигурация
│   └── LazyBear.MCP.csproj    # Проектный файл
├── AGENTS.md                   # Этот файл, правила для агентов
└── README.md                   # Документация для пользователей

Основные концепты

Хостинг (Hosting):

• ASP.NET Core веб-приложение (.NET 10.0)
• HTTP transport для удалённой MCP коммуникации
• Авто-обнаружение [McpServerToolType] и [McpServerResourceType]

Технологический стек:

• Runtime: .NET 10.0
• Framework: ASP.NET Core
• SDK: ModelContextProtocol.AspNetCore 1.2.0
• AI: Microsoft.Extensions.AI

Особенности MCP:

• Инструменты (Tools): Статические классы с атрибутами [McpServerTool]
• Ресурсы (Resources): Шаблоны ресурсов с атрибутами [McpServerResource]
• Промпты (Prompts): Параметризованные промпты (в разработке)

Запуск

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

dotnet run --project LazyBear.MCP

Собрать проект:

dotnet build

Пакеты

• ModelContextProtocol - основной SDK
• ModelContextProtocol.AspNetCore - интеграция с ASP.NET Core
• Microsoft.Extensions.AI - абстракции AI

---

Правила для машин (MACHINE-FIRST)

Обязательные правила (MUST)

Перед модификацией:

1. Прочитать существующий код
2. Сохранять текущий стиль и паттерны
3. Минимизировать изменения
4. Не добавлять секреты в код

Перед коммитом:

1. Сборка dotnet build должна проходить локально
2. Изменения не должны ломать MCP протокол
3. Код в Git только после проверки сборки
4. Комментарии, документация и коммиты — только на русском

---

Модель выполнения (MUST)

Приоритеты инструкции:

1. Инструкции пользователя
2. AGENTS.md (этот файл)
3. Упомянутые общие правила
4. Существующий стиль кода
5. Лучшие практики

Переиспользуемые правила:

• AGENT.common.md - общие правила
• AGENT.interaction.md - правила взаимодействия

Поддержание правил (MUST)

• см. AGENT.common.md → Rules Maintenance