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>
75 lines
2.8 KiB
Markdown
75 lines
2.8 KiB
Markdown
# 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)
|