# projects-meta-mcp

MCP-сервер: агрегирует статусы задач (`.tasks/STATUS.md`) и общие знания (репо `projects-wiki`, локально клонится в `~/projects/.wiki/`) поверх множества проектов и нескольких машин.

- Источник правды: Gitea (`https://git.kzntsv.site`, owner `OpeItcLoc03`).
- Процесс — локальный на каждой машине (offline-критично).
- Данные — локальный кэш + клон `projects-wiki`, синхронизируются скриптом.

## Bootstrap

```bash
git clone https://git.kzntsv.site/OpeItcLoc03/projects-meta-mcp ~/.local/projects-meta-mcp
cd ~/.local/projects-meta-mcp
npm install && npm run build

git clone https://git.kzntsv.site/OpeItcLoc03/projects-wiki ~/projects/.wiki

mkdir -p ~/.config/projects-mcp
cp auth.toml.example ~/.config/projects-mcp/auth.toml
# отредактировать auth.toml — заполнить gitea_token

node dist/sync.js   # первый sync
```

## Регистрация в Claude Code

Добавить в `~/.claude.json` (расположение файла см. ниже для вашей ОС):

### Windows (PowerShell)

```json
{
  "mcpServers": {
    "projects-meta": {
      "command": "node",
      "args": ["C:\\Users\\<USER>\\.local\\projects-meta-mcp\\dist\\server.js"]
    }
  }
}
```

Файл расположен по адресу: `%USERPROFILE%\.claude.json`

### Linux / macOS

```json
{
  "mcpServers": {
    "projects-meta": {
      "command": "node",
      "args": ["/home/<USER>/.local/projects-meta-mcp/dist/server.js"]
    }
  }
}
```

Файл расположен по адресу: `~/.claude.json`

**Примечание:** замените `<USER>` на ваше имя пользователя.

## Tools

| Tool | Назначение |
|------|------------|
| `tasks.aggregate` | Свод активных задач по всем проектам |
| `tasks.search` | Поиск по slug/next-action |
| `tasks.get` | Полный STATUS.md одного проекта |
| `knowledge.search` | Поиск по shared-вики, фильтр по домену cwd |
| `knowledge.get` | Полный текст одной страницы |
| `knowledge.suggest_promote` | Кандидаты на промоушен из `.wiki/concepts/` текущего проекта |
| `meta.status` | Возраст кэша + диагностика |

См. дизайн: [docs/superpowers/specs/2026-04-29-projects-meta-mcp-design.md](docs/superpowers/specs/2026-04-29-projects-meta-mcp-design.md)
План реализации: [docs/superpowers/plans/2026-04-29-bootstrap-implementation.md](docs/superpowers/plans/2026-04-29-bootstrap-implementation.md)