MCP-сервер руководств Glanser

Семантический поиск по корпусу руководств по кодированию команды. Работает на базе FastMCP + ChromaDB + sentence-transformers (all-MiniLM-L6-v2). 100% бесплатно — никаких API-ключей, никаких внешних сервисов, работает полностью автономно после настройки.

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

mcp-server/
├── server.py          ← MCP server (run this on the host)
├── ingest.py          ← One-time ingestion script
├── requirements.txt   ← Python dependencies
├── documents/         ← Drop your .md guideline files here
│   └── CODING_GUIDELINES.md
└── chroma_db/         ← Created automatically by ingest.py (do not edit)

Настройка (выполнить один раз на хост-машине)

1. Установка зависимостей

pip install -r requirements.txt

sentence-transformers загрузит модель all-MiniLM-L6-v2 (~80 МБ) при первом запуске и закэширует её. Последующие запуски выполняются полностью автономно.

2. Добавление документов

Скопируйте Markdown-файлы в папку documents/:

cp /path/to/CODING_GUIDELINES.md documents/

3. Индексация (выполняется один раз, сохраняется на диск)

python ingest.py

Это считывает каждый файл .md в documents/, создает эмбеддинги для каждого раздела и сохраняет векторы в chroma_db/. Вам нужно перезапускать это только при добавлении нового документа.

Полезные флаги:

python ingest.py --file documents/NEW_DOC.md   # add a single new doc
python ingest.py --reset                        # wipe and re-ingest everything
python ingest.py --list                         # see what is currently indexed

4. Запуск сервера

python server.py

Сервер запускается по адресу http://0.0.0.0:8000.

Хостинг (доступ для команды)

Разверните на Railway или Render (оба имеют бесплатные тарифы):

Отправьте эту папку mcp-server/ в git-репозиторий
Создайте новый сервис, указывающий на этот репозиторий
Установите команду запуска: python server.py
Подключите постоянный том (persistent volume) по пути /app/chroma_db (чтобы эмбеддинги сохранялись после развертывания)
Запустите python ingest.py один раз через консоль хоста после развертывания

Railway/Render автоматически предоставят HTTPS URL, например: https://glanser-guidelines-mcp.railway.app

Запись в .mcp.json для команды

Каждый член команды добавляет это в свой файл .mcp.json:

{
  "mcpServers": {
    "coding-guidelines": {
      "type": "http",
      "url": "https://your-hosted-domain.com/mcp"
    }
  }
}

Доступные инструменты

Инструмент	Что он делает
`search_guidelines`	Семантический поиск по всем документам — используйте его в первую очередь
`get_section`	Получить полное содержимое конкретного раздела
`list_sections`	Просмотреть все заголовки разделов во всем корпусе
`get_by_scope`	Фильтрация правил по `library`, `client` или `both`
`list_documents`	Просмотреть все проиндексированные документы и количество разделов в них

Добавление нового документа

# 1. Copy the new doc
cp NEW_GUIDELINES.md documents/

# 2. Ingest only the new file (does not re-embed existing docs)
python ingest.py --file documents/NEW_GUIDELINES.md

# 3. No server restart needed — ChromaDB is queried live

Локальная разработка / тестирование (без хостинга)

{
  "mcpServers": {
    "coding-guidelines": {
      "type": "http",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Glanser Guidelines MCP Server