Files
factory/lib/projects-meta-mcp/README.md
vitya ca669d96e1 feat(lib): bundle MCP servers from .common/lib into factory/lib/
Copies source (no node_modules, dist, .tasks, .wiki, __pycache__) for:
- projects-meta-mcp v2.25.0 (TypeScript/Node)
- wiki-graph v0.3.1 (TypeScript/Node)
- interns-mcp v0.3.3 (Python/FastMCP)

.gitignore: exclude lib build artefacts (node_modules, dist, .venv, __pycache__, *.pyc)
bootstrap.ps1: add MCP build step — npm install+build for TS servers, venv+pip for Python

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-11 13:17:29 +03:00

75 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)