96 lines
3.5 KiB
Markdown
96 lines
3.5 KiB
Markdown
# AGENTS.md
|
||
|
||
## Описание проекта: LazyBear MCP
|
||
|
||
### Назначение
|
||
.NET 10 сервер Model Context Protocol (MCP) для интеграции торговых AI-инструментов.
|
||
|
||
### Структура проекта
|
||
```
|
||
LazyBearWorks/
|
||
├── LazyBear.MCP/
|
||
│ ├── Program.cs # Главный файл с хостингом MCP сервера
|
||
│ └── Services/
|
||
│ └── TradingTools.cs # Реализация инструментов MCP
|
||
├── 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):** Параметризованные промпты (в разработке)
|
||
|
||
### Запуск
|
||
|
||
**Запустить сервер:**
|
||
```bash
|
||
dotnet run --project LazyBear.MCP
|
||
```
|
||
|
||
**Собрать проект:**
|
||
```bash
|
||
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. Комментарии, документация и коммиты — только на русском
|
||
|
||
### Build & Deploy
|
||
- Локальная сборка обязана проходить
|
||
- Без ломающих изменений в MCP
|
||
- Коммиты с проверкой сборки
|
||
|
||
---
|
||
|
||
## Модель выполнения (MUST)
|
||
|
||
**Приоритеты инструкции:**
|
||
1. Инструкции пользователя
|
||
2. AGENTS.md (этот файл)
|
||
3. Упомянутые общие правила
|
||
4. Существующий стиль кода
|
||
5. Лучшие практики
|
||
|
||
**Переиспользуемые правила:**
|
||
- [AGENT.common.md](AGENT.common.md) - общие правила
|
||
- [AGENT.interaction.md](AGENT.interaction.md) - правила взаимодействия
|
||
|
||
### Поддержание правил (MUST)
|
||
- Минимальные обновления
|
||
- Объединение дубликатов
|
||
- Сохранение смысла
|