factory/lib/projects-meta-mcp

projects-meta-mcp

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

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

Bootstrap

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)

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

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

Linux / macOS

{
  "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/plans/2026-04-29-bootstrap-implementation.md