@agentrica/mcp 0.4.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +75 -0
- package/README.en.md +101 -27
- package/README.md +100 -28
- package/dist/catalog/src/departments.d.ts +2 -0
- package/dist/catalog/src/departments.js +5 -0
- package/dist/mcp/src/init.d.ts +1 -1
- package/dist/mcp/src/init.js +9 -6
- package/dist/mcp/src/page/app.js +74 -5
- package/dist/mcp/src/page/index.html +5 -0
- package/dist/mcp/src/page/style.css +9 -0
- package/dist/mcp/src/panel.d.ts +17 -1
- package/dist/mcp/src/panel.js +40 -2
- package/dist/mcp/src/prompt.d.ts +8 -2
- package/dist/mcp/src/prompt.js +18 -2
- package/dist/mcp/src/ratings.d.ts +86 -0
- package/dist/mcp/src/ratings.js +159 -0
- package/dist/mcp/src/server.js +183 -19
- package/dist/mcp/src/setup.d.ts +25 -0
- package/dist/mcp/src/setup.js +161 -0
- package/dist/mcp/src/update.d.ts +10 -0
- package/dist/mcp/src/update.js +65 -0
- package/package.json +6 -4
- package/starter/CONVENTIONS.md +1 -1
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
# Novità di @agentrica/mcp
|
|
2
|
+
|
|
3
|
+
Ogni versione con la data di pubblicazione su npm e le novità per tipo: Nuovo, Cambiato, Corretto, Incompatibile. La versione si fissa nel comando del server (`@agentrica/mcp@<versione>`): un aggiornamento arriva solo quando la cambi tu.
|
|
4
|
+
|
|
5
|
+
## 0.6.0 — 2026-11-18
|
|
6
|
+
|
|
7
|
+
### Nuovo
|
|
8
|
+
- `npx -y @agentrica/mcp@0.6.0 install`: installa il pacchetto sul computer con `npm install -g` e lo registra in Claude Code per tutti i tuoi progetti. Lo stesso comando su Mac, Windows e Linux; per aggiornare lo rilanci con la versione nuova.
|
|
9
|
+
- `npx -y @agentrica/mcp@0.6.0 add`: registra in Claude Code il server avviato con npx, senza installare nulla; `--project` scrive `.mcp.json` per il team, `--local` vale solo per il progetto corrente.
|
|
10
|
+
- La valutazione la chiede il server con un modulo del client (elicitation MCP): quando carichi un altro agente, per quello di prima, e dopo 30 minuti d'uso. Una volta per agente; se rifiuti non te la chiede più. I client senza moduli hanno il flusso di prima.
|
|
11
|
+
- Avviso di versione nuova: all'avvio il server chiede al registro npm qual è l'ultima versione (nessun dato inviato) e, se ce n'è una più nuova, lo dice con il comando per aggiornare, nella risposta di un tool e nel banner del pannello. `--no-update-check` spegne il controllo.
|
|
12
|
+
- Questo file, `CHANGELOG.md`, al posto della sezione «Versioni» del README.
|
|
13
|
+
|
|
14
|
+
### Cambiato
|
|
15
|
+
- Il pannello scrive il nome del reparto accanto alla sigla: «reparto AISA · Software».
|
|
16
|
+
- Senza moduli, l'invito a valutare l'agente sta in fondo al suo testo, dopo il compito.
|
|
17
|
+
|
|
18
|
+
### Corretto
|
|
19
|
+
- Su Windows `init` scrive nel `.mcp.json` `cmd /c npx`: con `npx` da solo Claude Code non avviava il server.
|
|
20
|
+
|
|
21
|
+
### Incompatibile
|
|
22
|
+
- I prompt hanno il reparto nel nome: `aisa-02` diventa `aisa-02-software` (anche `-business`, `-cybersecurity`, `-privacy`, `-design`), così il menu dei comandi mostra il reparto. Restano uguali l'id dell'agente (`AISA-02`), il nome in codice, l'argomento del tool `agente` e `--agents`.
|
|
23
|
+
|
|
24
|
+
## 0.5.0 — 2026-11-17
|
|
25
|
+
|
|
26
|
+
### Nuovo
|
|
27
|
+
- Valutazione degli agenti: tool `rate_agent` in due passi, con anteprima e codice; sezione «Valuta gli agenti» nel pannello; proposta a fine lavoro e promemoria dopo 30 minuti. È l'unica connessione del server, e parte solo dopo la tua conferma; `--no-ratings` la toglie.
|
|
28
|
+
- L'agente dice chi è (nome in codice, ruolo, reparto) all'inizio, quando passa a un altro agente e nel riepilogo.
|
|
29
|
+
|
|
30
|
+
## 0.4.0 — 2026-11-16
|
|
31
|
+
|
|
32
|
+
### Nuovo
|
|
33
|
+
- Comando `init`: crea un progetto con regole, piano a fasi, agenzie, subagent, CI e `.mcp.json`. Prende il posto di agentic-starter. Il server è invariato.
|
|
34
|
+
|
|
35
|
+
## 0.3.3 — 2026-11-16
|
|
36
|
+
|
|
37
|
+
### Nuovo
|
|
38
|
+
- Export `@agentrica/mcp/catalog` per leggere reparti e agenti da codice. Agenti e comportamento del server invariati.
|
|
39
|
+
|
|
40
|
+
## 0.3.2 — 2026-11-16
|
|
41
|
+
|
|
42
|
+
### Cambiato
|
|
43
|
+
- Pannello in tre pagine (Sessione, Piano, Rilievi), con menu e contatori delle scelte in attesa e dei rilievi. Agenti e comportamento del server invariati.
|
|
44
|
+
|
|
45
|
+
## 0.3.1 — 2026-11-15
|
|
46
|
+
|
|
47
|
+
### Cambiato
|
|
48
|
+
- Regole comuni con una scala di gravità condivisa (P0–P3) e una scala per il reparto software.
|
|
49
|
+
|
|
50
|
+
### Corretto
|
|
51
|
+
- Il pannello nasconde i rilievi chiusi e conta a parte i file nuovi.
|
|
52
|
+
- L'id del tool `agente` accetta solo le sigle dei reparti.
|
|
53
|
+
|
|
54
|
+
## 0.3.0 — 2026-11-15
|
|
55
|
+
|
|
56
|
+
### Nuovo
|
|
57
|
+
- Pannello locale con `--panel`: fasi, backlog, rilievi, agenti in uso e scelte da prendere dalla pagina (tool `open_panel` e `ask_user`). Senza `--panel` nulla cambia.
|
|
58
|
+
|
|
59
|
+
## 0.2.1 — 2026-11-15
|
|
60
|
+
|
|
61
|
+
### Nuovo
|
|
62
|
+
- Nome `io.github.flgisimone/agentrica` per il registro MCP ufficiale. Agenti e comportamento invariati.
|
|
63
|
+
|
|
64
|
+
## 0.2.0 — 2026-11-15
|
|
65
|
+
|
|
66
|
+
### Nuovo
|
|
67
|
+
- Argomento `--agents` per caricare solo una squadra di agenti o reparti.
|
|
68
|
+
|
|
69
|
+
### Cambiato
|
|
70
|
+
- Con un progetto vuoto, o senza ciò che il ruolo deve esaminare, l'agente lo dice e propone i primi passi da confermare, senza inventare rilievi.
|
|
71
|
+
|
|
72
|
+
## 0.1.0 — 2026-11-15
|
|
73
|
+
|
|
74
|
+
### Nuovo
|
|
75
|
+
- Prima versione pubblicata: 56 agenti in cinque reparti, un prompt per agente e i tool `elenca_agenti` e `agente`.
|
package/README.en.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Agentrica MCP
|
|
2
2
|
|
|
3
|
+
[](https://mcprush.com/to/agentrica-mcp?ref=badge)
|
|
4
|
+
|
|
3
5
|
[Italiano](README.md)
|
|
4
6
|
|
|
5
7
|
The Agentrica MCP server: the 56 AI agents of the five departments (AIBPD, AICA, AIPCA, AISA, AIWDA), usable in your project from Claude Code or any MCP client.
|
|
@@ -12,22 +14,50 @@ The agent files are in Italian. The agent answers in the language you write in.
|
|
|
12
14
|
|
|
13
15
|
- The server runs only locally: the client starts it on your computer and the two talk over stdio. The server has no remote part.
|
|
14
16
|
- The only content it reads is the `agents/` files included in the package, once, at startup. The text that reaches the model is the text of those files: you can read it before using it.
|
|
15
|
-
- The server writes no files (only the [`init`](#new-project) command does, when you run it),
|
|
17
|
+
- The server writes no files (only the [`init`](#new-project) command does, when you run it), logs nothing and has no telemetry. It connects to the internet in two cases:
|
|
18
|
+
- to Agentrica, when you confirm an [agent rating](#ratings), and it sends only the score, the comment and the version; `--no-ratings` turns it off;
|
|
19
|
+
- to the npm registry, at startup, to find out whether there is a [new version](#updating-and-uninstalling): a request with no data, npm only sees your IP address and program, as when npx downloads the package; `--no-update-check` turns it off.
|
|
20
|
+
|
|
21
|
+
With `--no-ratings --no-update-check` it never connects. With `--panel` it opens a page on your computer only: see [Local panel](#local-panel).
|
|
16
22
|
- It runs nothing in your project. It only gives instructions to the model: what the model does in the project depends on the client and on the permissions you grant it.
|
|
17
23
|
- **Where the data goes.** The agent's text, the task and the files the model reads in your project go to the model provider through your client, under that provider's terms. Agentrica does not receive them. Leave personal data, secrets and customer data out of the task unless they are needed.
|
|
18
24
|
- The agents are AI: their conclusions are proposals to check. The privacy and security agents do not replace a DPO, a lawyer or a security officer, and their findings are not a compliance certification.
|
|
19
25
|
|
|
20
26
|
## Installation
|
|
21
27
|
|
|
22
|
-
You need Node 22 or later, with npm.
|
|
28
|
+
You need Node 22 or later, with npm. The commands are the same on Mac, Windows (PowerShell or cmd) and Linux.
|
|
29
|
+
|
|
30
|
+
**On the whole computer (recommended)**, for Claude Code:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
npx -y @agentrica/mcp@0.6.0 install
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
It installs the package with `npm install -g` and registers it in Claude Code with `user` scope: every project you open already has Agentrica. The server starts with `node` from npm's global folder: it starts fast and also works offline. Restart Claude Code and check with `claude mcp list`.
|
|
37
|
+
|
|
38
|
+
**Without installing anything**, for Claude Code:
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
npx -y @agentrica/mcp@0.6.0 add
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
It registers the server started with npx (on Windows `cmd /c npx`), which downloads the package to its cache on first start. The scope is `user`, all your projects; with `--project` it writes `.mcp.json` in the current folder, to share with your team (it works on the system it was created on), with `--local` it applies to the current project and to you only. For your team, from the project folder:
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
npx -y @agentrica/mcp@0.6.0 add --project
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
The server options (`--agents`, `--panel`, `--no-ratings`, `--no-update-check`) go at the end of `install` and `add`, which pass them to the server. Run again, they replace Agentrica's registration in the same scope. If Node 22, npm or the `claude` command are missing, they say so and print the commands to run by hand.
|
|
51
|
+
|
|
52
|
+
The version stays the one you set until you change it: role updates do not arrive unless you choose them. See [Updating and uninstalling](#updating-and-uninstalling).
|
|
23
53
|
|
|
24
|
-
**Claude Code**,
|
|
54
|
+
**By hand in Claude Code**, without `install` or `add`:
|
|
25
55
|
|
|
26
56
|
```sh
|
|
27
|
-
claude mcp add agentrica -- npx -y @agentrica/mcp@0.
|
|
57
|
+
claude mcp add --scope user agentrica -- npx -y @agentrica/mcp@0.6.0
|
|
28
58
|
```
|
|
29
59
|
|
|
30
|
-
On
|
|
60
|
+
On Windows: `claude mcp add --scope user agentrica -- cmd /c npx -y @agentrica/mcp@0.6.0`.
|
|
31
61
|
|
|
32
62
|
**Other MCP clients**: add the server to the client configuration, usually a JSON file like this:
|
|
33
63
|
|
|
@@ -36,23 +66,42 @@ On first start npx downloads the package from npm. The version stays the one you
|
|
|
36
66
|
"mcpServers": {
|
|
37
67
|
"agentrica": {
|
|
38
68
|
"command": "npx",
|
|
39
|
-
"args": ["-y", "@agentrica/mcp@0.
|
|
69
|
+
"args": ["-y", "@agentrica/mcp@0.6.0"]
|
|
40
70
|
}
|
|
41
71
|
}
|
|
42
72
|
}
|
|
43
73
|
```
|
|
44
74
|
|
|
45
|
-
|
|
75
|
+
On Windows:
|
|
76
|
+
|
|
77
|
+
```json
|
|
78
|
+
{
|
|
79
|
+
"mcpServers": {
|
|
80
|
+
"agentrica": {
|
|
81
|
+
"command": "cmd",
|
|
82
|
+
"args": ["/c", "npx", "-y", "@agentrica/mcp@0.6.0"]
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
**Least privilege (recommended).** Install the package in its own folder and start it with Node's permission model: the server can only read that folder, and Node blocks file writes, network connections and child processes. The server needs none of them, so it works the same; the permissions limit the damage of any future defect. With these permissions, sending a [rating](#ratings) fails with a clear message and the version check does not run: to rate agents add `--allow-net`, otherwise add `--no-ratings --no-update-check` at the end of the command.
|
|
46
89
|
|
|
47
90
|
```sh
|
|
48
|
-
npm install -g --ignore-scripts @agentrica/mcp@0.
|
|
91
|
+
npm install -g --ignore-scripts @agentrica/mcp@0.6.0
|
|
49
92
|
npm root -g
|
|
50
93
|
```
|
|
51
94
|
|
|
52
95
|
With the folder printed by `npm root -g` in place of `/global/folder`:
|
|
53
96
|
|
|
54
97
|
```sh
|
|
55
|
-
claude mcp add agentrica -- node --permission --allow-fs-read=/global/folder/@agentrica/mcp /global/folder/@agentrica/mcp/dist/mcp/src/server.js
|
|
98
|
+
claude mcp add --scope user agentrica -- node --permission --allow-fs-read=/global/folder/@agentrica/mcp /global/folder/@agentrica/mcp/dist/mcp/src/server.js
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
On Windows the folder is usually `C:\Users\<name>\AppData\Roaming\npm\node_modules`; if it contains spaces, quote the path and the whole option:
|
|
102
|
+
|
|
103
|
+
```sh
|
|
104
|
+
claude mcp add --scope user agentrica -- node --permission "--allow-fs-read=C:\Users\<name>\AppData\Roaming\npm\node_modules\@agentrica\mcp" "C:\Users\<name>\AppData\Roaming\npm\node_modules\@agentrica\mcp\dist\mcp\src\server.js"
|
|
56
105
|
```
|
|
57
106
|
|
|
58
107
|
**Provenance.** The package is published by the repository CI with provenance: npm shows which commit it was built from, and `npm audit signatures` in your project verifies its signature.
|
|
@@ -61,18 +110,20 @@ claude mcp add agentrica -- node --permission --allow-fs-read=/global/folder/@ag
|
|
|
61
110
|
|
|
62
111
|
## Usage
|
|
63
112
|
|
|
64
|
-
**Prompts.** Each agent is a prompt named after its lowercase id (`aisa-02`, `aica-01
|
|
113
|
+
**Prompts.** Each agent is a prompt named after its lowercase id and its department (`aisa-02-software`, `aica-01-cybersecurity`, `aibpd-01-business`, `aipca-02-privacy`, `aiwda-08-design`) with one optional argument, `compito` (the task). In Claude Code prompts become commands, and the menu shows the department:
|
|
65
114
|
|
|
66
115
|
```
|
|
67
|
-
/mcp__agentrica__aisa-02 "Review the boundaries between the modules in src/"
|
|
116
|
+
/mcp__agentrica__aisa-02-software "Review the boundaries between the modules in src/"
|
|
68
117
|
```
|
|
69
118
|
|
|
119
|
+
Up to 0.5.0 the name was the id alone (`aisa-02`).
|
|
120
|
+
|
|
70
121
|
Put the task in quotes: Claude Code splits arguments on spaces.
|
|
71
122
|
|
|
72
123
|
**Squad.** With `--agents` the server loads only the agents you list: agent ids and department codes, comma-separated, case-insensitive. For example the whole software department plus the accessibility agent:
|
|
73
124
|
|
|
74
125
|
```sh
|
|
75
|
-
|
|
126
|
+
npx -y @agentrica/mcp@0.6.0 install --agents aisa,aiwda-08
|
|
76
127
|
```
|
|
77
128
|
|
|
78
129
|
The command menu shows only the squad's prompts, and `elenca_agenti` and `agente` see only those agents too. Without `--agents` all 56 agents are available. An unknown id or code stops the server with a message naming it, in the client's logs. In Claude Code prompts do not enter the model's context (we checked with `/context`): a squad makes the menu shorter, it does not save tokens.
|
|
@@ -83,22 +134,40 @@ The command menu shows only the squad's prompts, and `elenca_agenti` and `agente
|
|
|
83
134
|
|---|---|---|
|
|
84
135
|
| `elenca_agenti` (list agents) | optional `reparto` (department: `AIBPD`, `AICA`, `AIPCA`, `AISA`, `AIWDA`) | id, code name, role and department of each agent |
|
|
85
136
|
| `agente` (agent) | `id` (e.g. `AISA-02`), optional `compito` (task) | the agent's full instructions |
|
|
137
|
+
| `rate_agent` | `id`, `rating` from 1 to 5, optional `comment` and `publish`; then `code` | a preview of the rating and a code; with the code, the sending (see [Ratings](#ratings)) |
|
|
86
138
|
|
|
87
139
|
For example: "Use elenca_agenti, pick the right Agentrica agent and check the accessibility of the login form".
|
|
88
140
|
|
|
89
141
|
Number 01 in each department is the director: it coordinates the specialists and consolidates their findings.
|
|
90
142
|
|
|
143
|
+
While working, the agent says who it is, for example "AISA-02 · ALTAIR — Senior Software Architect, reparto AISA (AI Software)": at the start, when it hands over to another agent and in the final summary.
|
|
144
|
+
|
|
145
|
+
## Ratings
|
|
146
|
+
|
|
147
|
+
You can give an agent a score from 1 to 5 and a comment on what to improve: ratings are used to fix the role files.
|
|
148
|
+
|
|
149
|
+
- **The form.** If the client shows forms (MCP elicitation, like Claude Code), the server asks you itself, with a form: score, comment and whether to publish it. It asks when you load another agent, for the previous one, which has finished, and after 30 minutes of use. Once per agent per session: if you decline, it does not ask again for that agent. Submitting the form is the confirmation, and only what is in the form is sent.
|
|
150
|
+
- **Without forms.** With clients that do not show forms, the agent suggests a rating when it has finished the task, once per session; if it has been working for more than 30 minutes, the server reminds the model once. `rate_agent` first shows a preview of what will be sent and a code valid for 10 minutes; the model shows it to you and sends only with the code, exactly that content.
|
|
151
|
+
- You can also ask ("rate AISA-02"), or rate from the panel (`--panel`), in the "Valuta gli agenti" section.
|
|
152
|
+
- **What is sent.** The agent id, the score, the comment, whether you allow the comment to be published on the site (off by default), the package version and a random rating code. No task, files, paths or project name, no account. Do not write names, personal data or parts of your project in the comment.
|
|
153
|
+
- **On the site.** Every agent with at least 5 ratings shows the average, the number of ratings and their distribution, and a ranking appears once at least 5 agents pass that threshold. A comment appears only if you allowed it to be published and after it is approved (criteria in the [legal notes](https://agentrica.vercel.app/note-legali#valutazioni), in Italian), with the score and the month.
|
|
154
|
+
- **After sending** you get the rating code: with it you can ask for the rating to be deleted or for the comment not to be published. An agent can be rated once per session and once a day from the same network.
|
|
155
|
+
- **If sending fails** (offline, service down) the tool says so and the work goes on; the rating is not stored anywhere.
|
|
156
|
+
- **To drop the tool**, the form and the suggestions, add `--no-ratings` to the command: the server no longer connects to Agentrica.
|
|
157
|
+
|
|
158
|
+
How ratings are handled: [legal notes](https://agentrica.vercel.app/note-legali#valutazioni) (in Italian).
|
|
159
|
+
|
|
91
160
|
## Local panel
|
|
92
161
|
|
|
93
162
|
With `--panel` the server also opens a page on your computer where you follow the project and make the choices the agent asks you for, instead of answering in the terminal:
|
|
94
163
|
|
|
95
164
|
```sh
|
|
96
|
-
|
|
165
|
+
npx -y @agentrica/mcp@0.6.0 install --panel
|
|
97
166
|
```
|
|
98
167
|
|
|
99
168
|
Then ask the agent to open the panel (`open_panel` tool): the page opens in your browser. It has three pages, with a menu at the top counting pending choices and findings:
|
|
100
169
|
|
|
101
|
-
- **Sessione** (session): pending choices (*Da decidere*, to decide), with options and reasons, whose answer, with an optional note, goes back to the agent; next to them, the Agentrica agents called in this session (*Agenti in uso*, agents in use), with the start of the task;
|
|
170
|
+
- **Sessione** (session): pending choices (*Da decidere*, to decide), with options and reasons, whose answer, with an optional note, goes back to the agent; next to them, the Agentrica agents called in this session (*Agenti in uso*, agents in use), with the department and the start of the task;
|
|
102
171
|
- **Piano** (plan): the open phase with backlog and acceptance criteria, and all project phases;
|
|
103
172
|
- **Rilievi** (findings): open findings from phases and audits, by priority and department.
|
|
104
173
|
|
|
@@ -111,7 +180,7 @@ With the panel the model has two more tools:
|
|
|
111
180
|
|
|
112
181
|
If the page is not open, `ask_user` opens it. The client waits for the answer as long as the server sends progress notifications (up to 4 hours; 25 minutes with a client that does not request them), then the agent asks in the terminal. The client's own questions, such as tool permissions, stay in the client.
|
|
113
182
|
|
|
114
|
-
**What changes with `--panel`.** The server opens a random port on `127.0.0.1` only, reads `plan/`, `audit/` and the git status (`git status`) of the project folder, and keeps the last 20 agent calls in memory. It writes no files and sends no data off your computer. The page opens only with the random token in the URL, valid for that session; requests from other sites or with another `Host` are refused. The Node permission model recommended above does not apply with `--panel`, which needs the local network and `git`.
|
|
183
|
+
**What changes with `--panel`.** The server opens a random port on `127.0.0.1` only, reads `plan/`, `audit/` and the git status (`git status`) of the project folder, and keeps the last 20 agent calls in memory. It writes no files and sends no data off your computer, except the ratings you send from the page. The page opens only with the random token in the URL, valid for that session; requests from other sites or with another `Host` are refused. The Node permission model recommended above does not apply with `--panel`, which needs the local network and `git`.
|
|
115
184
|
|
|
116
185
|
**Format of `plan/` and `audit/`.** The panel reads the plan format created by `init`, in Italian, the same as Agentrica's own [`plan/`](https://github.com/flgisimone/agentrica/tree/main/plan) and [`audit/`](https://github.com/flgisimone/agentrica/tree/main/audit); if something is missing, the page says what.
|
|
117
186
|
|
|
@@ -124,7 +193,7 @@ If the page is not open, `ask_user` opens it. The client waits for the answer as
|
|
|
124
193
|
`init` creates a project with Agentrica's way of working, ready for Claude Code:
|
|
125
194
|
|
|
126
195
|
```sh
|
|
127
|
-
npx -y @agentrica/mcp@0.
|
|
196
|
+
npx -y @agentrica/mcp@0.6.0 init my-project --name "My project"
|
|
128
197
|
```
|
|
129
198
|
|
|
130
199
|
Without a folder it uses the current one; without `--name` the name is the folder's. It writes, in Italian:
|
|
@@ -133,7 +202,7 @@ Without a folder it uses the current one; without `--name` the name is the folde
|
|
|
133
202
|
- `plan/` with `README.md` (decisions, glossary, phases) and `00-base.md`, the F0 phase to start from; `audit/` and `docs/`;
|
|
134
203
|
- `agents/` and `.claude/agents/`: the 56 roles of this version and one subagent per role, with the project name;
|
|
135
204
|
- `.github/workflows/ci.yml` (`npm run verify` and `verify:e2e`, skipped until F0 creates them), `.gitignore`, `.nvmrc`, `.env.example`;
|
|
136
|
-
- `.mcp.json` with this server at an exact version and `--panel`, so the panel reads the plan right away.
|
|
205
|
+
- `.mcp.json` with this server at an exact version and `--panel`, so the panel reads the plan right away (on Windows with `cmd /c npx`).
|
|
137
206
|
|
|
138
207
|
If even one file already exists, `init` writes nothing and lists them. Outside a git repository it makes the first commit on `main` and leaves `develop` checked out; inside one it does not commit. Then open Claude Code in the folder and ask it to open phase F0. `init` is the only command that writes files: the server stays read-only. It replaces agentic-starter, which is no longer updated.
|
|
139
208
|
|
|
@@ -149,22 +218,27 @@ Three agents tested on 2026-11-15 against three small projects with planted, doc
|
|
|
149
218
|
|
|
150
219
|
Limits: the defects are few, known and fairly obvious; one model and one run per case; a result like this says nothing about how an agent does on a large project. Projects, expected defects, counting rules and the agents' full reports (in Italian) are in [`examples/`](https://github.com/flgisimone/agentrica/tree/main/examples): you can repeat the tests.
|
|
151
220
|
|
|
152
|
-
##
|
|
221
|
+
## Updating and uninstalling
|
|
222
|
+
|
|
223
|
+
The agents' text comes from the `agents/` files of the installed version. When a new version is out the server tells you once per session, in a tool response and in the panel, with the right command for how you installed it. Ids and code names do not change.
|
|
224
|
+
|
|
225
|
+
- **Installed with `install`**: run `install` again with the new version, e.g. `npx -y @agentrica/mcp@<version> install`, then restart Claude Code.
|
|
226
|
+
- **With `add` or `init`**: run `add` again with the new version, or change the version in the server command or in `.mcp.json`, then restart the client.
|
|
227
|
+
|
|
228
|
+
To uninstall:
|
|
229
|
+
|
|
230
|
+
```sh
|
|
231
|
+
claude mcp remove agentrica --scope user
|
|
232
|
+
npm uninstall -g @agentrica/mcp
|
|
233
|
+
```
|
|
153
234
|
|
|
154
|
-
The
|
|
235
|
+
The second command is needed only if you used `install`; with `add --project` or `--local` use that scope instead of `user`.
|
|
155
236
|
|
|
156
237
|
The same catalog can be read from code, without starting the server: `import { loadCatalog } from "@agentrica/mcp/catalog"` returns departments and agents (with the `Department` and `Agent` types) from the package's `agents/`. The Agentrica site uses it.
|
|
157
238
|
|
|
158
239
|
## Versions
|
|
159
240
|
|
|
160
|
-
|
|
161
|
-
- **0.3.3**: `@agentrica/mcp/catalog` export to read departments and agents from code (used by the site, now in a separate repository); agents and server behaviour unchanged.
|
|
162
|
-
- **0.3.2**: the panel has three pages (Sessione, Piano, Rilievi) with a menu counting pending choices and findings; agents and server behaviour unchanged.
|
|
163
|
-
- **0.3.1**: the panel hides closed findings and counts new files separately; the `agente` tool only accepts department codes in ids; common rules with a shared severity scale (P0–P3) and a scale for the software department.
|
|
164
|
-
- **0.3.0**: local panel with `--panel`: phases, backlog, findings, agents in use and choices made from the page (`open_panel` and `ask_user` tools). Without `--panel` nothing changes.
|
|
165
|
-
- **0.2.1**: name `io.github.flgisimone/agentrica` for the official MCP registry; agents and behaviour unchanged.
|
|
166
|
-
- **0.2.0**: `--agents` argument to load only a squad of agents or departments; in an empty project, or when what the role must examine is missing, the agent says so and proposes first steps to confirm, without inventing findings.
|
|
167
|
-
- **0.1.0**: first published version. 56 agents in five departments, one prompt per agent and the `elenca_agenti` and `agente` tools.
|
|
241
|
+
What changed in each version, with its date, is in [CHANGELOG.md](https://github.com/flgisimone/agentrica/blob/main/packages/mcp/CHANGELOG.md) (in Italian). 0.6.0 renames the prompts (`aisa-02` becomes `aisa-02-software`).
|
|
168
242
|
|
|
169
243
|
## License
|
|
170
244
|
|
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Agentrica MCP
|
|
2
2
|
|
|
3
|
+
[](https://mcprush.com/to/agentrica-mcp?ref=badge)
|
|
4
|
+
|
|
3
5
|
[English](README.en.md)
|
|
4
6
|
|
|
5
7
|
Il server MCP di Agentrica: i 56 agenti IA dei cinque reparti (AIBPD, AICA, AIPCA, AISA, AIWDA) usabili nel tuo progetto da Claude Code o da qualsiasi client MCP.
|
|
@@ -10,22 +12,50 @@ Ogni agente è un ruolo con un metodo e dei limiti dichiarati, per esempio `AISA
|
|
|
10
12
|
|
|
11
13
|
- Il server gira solo in locale: lo avvia il client sul tuo computer e i due comunicano con stdio. Il server non ha una parte remota.
|
|
12
14
|
- Come contenuto legge solo i file di `agents/` inclusi nel pacchetto, una volta all'avvio. Il testo che arriva al modello è quello di quei file: puoi leggerlo prima di usarlo.
|
|
13
|
-
- Il server non scrive file (lo fa solo il comando [`init`](#nuovo-progetto), quando lo lanci tu), non
|
|
15
|
+
- Il server non scrive file (lo fa solo il comando [`init`](#nuovo-progetto), quando lo lanci tu), non registra e non ha telemetria. Si collega a internet in due casi:
|
|
16
|
+
- verso Agentrica, quando confermi la [valutazione di un agente](#valutazioni), e invia solo voto, commento e versione; `--no-ratings` lo spegne;
|
|
17
|
+
- verso il registro npm, all'avvio, per sapere se c'è una [versione nuova](#aggiornare-e-disinstallare): è una richiesta senza dati, npm vede solo indirizzo IP e programma, come quando npx scarica il pacchetto; `--no-update-check` lo spegne.
|
|
18
|
+
|
|
19
|
+
Con `--no-ratings --no-update-check` non si collega mai. Con `--panel` apre una pagina solo sul tuo computer: vedi [Pannello locale](#pannello-locale).
|
|
14
20
|
- Non esegue niente nel tuo progetto. Dà soltanto istruzioni al modello: quello che il modello fa nel progetto dipende dal client e dai permessi che gli concedi.
|
|
15
21
|
- **Dove vanno i dati.** Il testo dell'agente, il compito e i file che il modello legge nel tuo progetto vanno al fornitore del modello attraverso il tuo client, secondo le condizioni di quel fornitore. Agentrica non li riceve. Nel compito non inserire dati personali, segreti o dati di clienti che non servono.
|
|
16
22
|
- Gli agenti sono IA: le loro conclusioni sono proposte da verificare. Gli agenti di privacy e sicurezza non sostituiscono un DPO, un avvocato o un responsabile della sicurezza, e i loro rilievi non sono una certificazione di conformità.
|
|
17
23
|
|
|
18
24
|
## Installazione
|
|
19
25
|
|
|
20
|
-
Serve Node 22 o successivo, con npm.
|
|
26
|
+
Serve Node 22 o successivo, con npm. I comandi sono gli stessi su Mac, Windows (PowerShell o cmd) e Linux.
|
|
27
|
+
|
|
28
|
+
**Su tutto il computer (consigliato)**, per Claude Code:
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
npx -y @agentrica/mcp@0.6.0 install
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Installa il pacchetto con `npm install -g` e lo registra in Claude Code con ambito `user`: ogni progetto che apri ha già Agentrica. Il server parte con `node` dalla cartella globale di npm: parte in fretta e funziona anche offline. Riavvia Claude Code e controlla con `claude mcp list`.
|
|
35
|
+
|
|
36
|
+
**Senza installare nulla**, per Claude Code:
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
npx -y @agentrica/mcp@0.6.0 add
|
|
40
|
+
```
|
|
21
41
|
|
|
22
|
-
|
|
42
|
+
Registra il server avviato con npx (su Windows `cmd /c npx`), che al primo avvio scarica il pacchetto nella sua cache. L'ambito è `user`, tutti i tuoi progetti; con `--project` scrive `.mcp.json` nella cartella corrente, da condividere con il team (vale per il sistema su cui l'hai creato), con `--local` vale solo per il progetto corrente e solo per te. Per il team, dalla cartella del progetto:
|
|
23
43
|
|
|
24
44
|
```sh
|
|
25
|
-
|
|
45
|
+
npx -y @agentrica/mcp@0.6.0 add --project
|
|
26
46
|
```
|
|
27
47
|
|
|
28
|
-
|
|
48
|
+
Le opzioni del server (`--agents`, `--panel`, `--no-ratings`, `--no-update-check`) si aggiungono in fondo a `install` e `add`, che le passano al server. Lanciati di nuovo, sostituiscono la registrazione di Agentrica nello stesso ambito. Se mancano Node 22, npm o il comando `claude`, lo dicono e stampano i comandi da lanciare a mano.
|
|
49
|
+
|
|
50
|
+
La versione resta quella indicata finché non la cambi tu: un aggiornamento dei ruoli non arriva senza che tu lo scelga. Vedi [Aggiornare e disinstallare](#aggiornare-e-disinstallare).
|
|
51
|
+
|
|
52
|
+
**A mano in Claude Code**, senza `install` né `add`:
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
claude mcp add --scope user agentrica -- npx -y @agentrica/mcp@0.6.0
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Su Windows: `claude mcp add --scope user agentrica -- cmd /c npx -y @agentrica/mcp@0.6.0`.
|
|
29
59
|
|
|
30
60
|
**Altri client MCP**: aggiungi il server alla configurazione del client, di solito un file JSON come questo:
|
|
31
61
|
|
|
@@ -34,23 +64,42 @@ Al primo avvio npx scarica il pacchetto da npm. La versione resta quella indicat
|
|
|
34
64
|
"mcpServers": {
|
|
35
65
|
"agentrica": {
|
|
36
66
|
"command": "npx",
|
|
37
|
-
"args": ["-y", "@agentrica/mcp@0.
|
|
67
|
+
"args": ["-y", "@agentrica/mcp@0.6.0"]
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Su Windows:
|
|
74
|
+
|
|
75
|
+
```json
|
|
76
|
+
{
|
|
77
|
+
"mcpServers": {
|
|
78
|
+
"agentrica": {
|
|
79
|
+
"command": "cmd",
|
|
80
|
+
"args": ["/c", "npx", "-y", "@agentrica/mcp@0.6.0"]
|
|
38
81
|
}
|
|
39
82
|
}
|
|
40
83
|
}
|
|
41
84
|
```
|
|
42
85
|
|
|
43
|
-
**Permessi minimi (consigliato).** Installa il pacchetto in una cartella sua e avvialo con il permission model di Node: il server può solo leggere quella cartella, e Node blocca scritture su file, connessioni di rete e processi figli. Il server non ne ha bisogno, quindi funziona uguale; i permessi limitano i danni di un eventuale difetto futuro.
|
|
86
|
+
**Permessi minimi (consigliato).** Installa il pacchetto in una cartella sua e avvialo con il permission model di Node: il server può solo leggere quella cartella, e Node blocca scritture su file, connessioni di rete e processi figli. Il server non ne ha bisogno, quindi funziona uguale; i permessi limitano i danni di un eventuale difetto futuro. Con questi permessi l'invio di una [valutazione](#valutazioni) fallisce con un messaggio chiaro e il controllo della versione non parte: se vuoi votare gli agenti aggiungi `--allow-net`, altrimenti aggiungi `--no-ratings --no-update-check` in fondo al comando.
|
|
44
87
|
|
|
45
88
|
```sh
|
|
46
|
-
npm install -g --ignore-scripts @agentrica/mcp@0.
|
|
89
|
+
npm install -g --ignore-scripts @agentrica/mcp@0.6.0
|
|
47
90
|
npm root -g
|
|
48
91
|
```
|
|
49
92
|
|
|
50
93
|
Con la cartella stampata da `npm root -g` al posto di `/cartella/globale`:
|
|
51
94
|
|
|
52
95
|
```sh
|
|
53
|
-
claude mcp add agentrica -- node --permission --allow-fs-read=/cartella/globale/@agentrica/mcp /cartella/globale/@agentrica/mcp/dist/mcp/src/server.js
|
|
96
|
+
claude mcp add --scope user agentrica -- node --permission --allow-fs-read=/cartella/globale/@agentrica/mcp /cartella/globale/@agentrica/mcp/dist/mcp/src/server.js
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Su Windows la cartella è di solito `C:\Users\<nome>\AppData\Roaming\npm\node_modules`; se contiene spazi, metti fra virgolette il percorso e l'intera opzione:
|
|
100
|
+
|
|
101
|
+
```sh
|
|
102
|
+
claude mcp add --scope user agentrica -- node --permission "--allow-fs-read=C:\Users\<nome>\AppData\Roaming\npm\node_modules\@agentrica\mcp" "C:\Users\<nome>\AppData\Roaming\npm\node_modules\@agentrica\mcp\dist\mcp\src\server.js"
|
|
54
103
|
```
|
|
55
104
|
|
|
56
105
|
**Provenienza.** Il pacchetto è pubblicato dalla CI del repository con provenance: su npm si vede da quale commit è stato costruito, e `npm audit signatures` nel tuo progetto ne verifica la firma.
|
|
@@ -59,18 +108,20 @@ claude mcp add agentrica -- node --permission --allow-fs-read=/cartella/globale/
|
|
|
59
108
|
|
|
60
109
|
## Uso
|
|
61
110
|
|
|
62
|
-
**Prompt.** Ogni agente è un prompt con il suo id in minuscolo (`aisa-02`, `aica-01
|
|
111
|
+
**Prompt.** Ogni agente è un prompt con il suo id in minuscolo e il reparto (`aisa-02-software`, `aica-01-cybersecurity`, `aibpd-01-business`, `aipca-02-privacy`, `aiwda-08-design`) e un argomento facoltativo, `compito`. In Claude Code i prompt diventano comandi, e il menu mostra il reparto:
|
|
63
112
|
|
|
64
113
|
```
|
|
65
|
-
/mcp__agentrica__aisa-02 "Rivedi i confini fra i moduli di src/"
|
|
114
|
+
/mcp__agentrica__aisa-02-software "Rivedi i confini fra i moduli di src/"
|
|
66
115
|
```
|
|
67
116
|
|
|
117
|
+
Fino alla 0.5.0 il nome era solo l'id (`aisa-02`).
|
|
118
|
+
|
|
68
119
|
Metti il compito fra virgolette: Claude Code separa gli argomenti con gli spazi.
|
|
69
120
|
|
|
70
121
|
**Squadra.** Con `--agents` il server carica solo gli agenti che indichi: id di agenti e sigle di reparti, separati da virgole, senza distinguere maiuscole. Per esempio tutto il reparto software più l'agente dell'accessibilità:
|
|
71
122
|
|
|
72
123
|
```sh
|
|
73
|
-
|
|
124
|
+
npx -y @agentrica/mcp@0.6.0 install --agents aisa,aiwda-08
|
|
74
125
|
```
|
|
75
126
|
|
|
76
127
|
Nel menu dei comandi restano solo i prompt della squadra, e anche `elenca_agenti` e `agente` vedono solo quelli. Senza `--agents` ci sono tutti i 56 agenti. Un id o una sigla sconosciuti fermano il server con un messaggio che li nomina, nei log del client. In Claude Code i prompt non entrano nel contesto del modello (lo abbiamo verificato con `/context`): la squadra rende il menu più corto, ma non fa risparmiare token.
|
|
@@ -81,24 +132,40 @@ Nel menu dei comandi restano solo i prompt della squadra, e anche `elenca_agenti
|
|
|
81
132
|
|---|---|---|
|
|
82
133
|
| `elenca_agenti` | `reparto` facoltativo (`AIBPD`, `AICA`, `AIPCA`, `AISA`, `AIWDA`) | id, nome in codice, ruolo e reparto di ogni agente |
|
|
83
134
|
| `agente` | `id` (es. `AISA-02`), `compito` facoltativo | le istruzioni complete dell'agente |
|
|
135
|
+
| `rate_agent` | `id`, `rating` da 1 a 5, `comment` e `publish` facoltativi; poi `code` | l'anteprima della valutazione e un codice; con il codice, l'invio (vedi [Valutazioni](#valutazioni)) |
|
|
84
136
|
|
|
85
137
|
Per esempio: «Usa elenca_agenti, scegli l'agente di Agentrica adatto e verifica l'accessibilità del form di login».
|
|
86
138
|
|
|
87
139
|
Il numero 01 di ogni reparto è il direttore: coordina gli specialisti e consolida i loro rilievi.
|
|
88
140
|
|
|
89
|
-
I file degli agenti sono in italiano; l'agente risponde nella lingua in cui gli scrivi.
|
|
141
|
+
I file degli agenti sono in italiano; l'agente risponde nella lingua in cui gli scrivi. Durante il lavoro l'agente dice chi è, per esempio «AISA-02 · ALTAIR — Senior Software Architect, reparto AISA (AI Software)»: all'inizio, quando passa a un altro agente e nel riepilogo finale.
|
|
142
|
+
|
|
143
|
+
## Valutazioni
|
|
144
|
+
|
|
145
|
+
Puoi dare a un agente un voto da 1 a 5 e un commento su cosa migliorare: servono a correggere i file di ruolo.
|
|
146
|
+
|
|
147
|
+
- **Il modulo.** Se il client mostra moduli (elicitation MCP, come Claude Code), è il server a chiedertelo, con un modulo: voto, commento e se pubblicarlo. Te lo chiede quando carichi un altro agente, per quello di prima, che ha finito, e dopo 30 minuti d'uso. Una volta per agente per sessione: se rifiuti, per quell'agente non te lo chiede più. Inviare il modulo vale come conferma, e parte solo ciò che c'è nel modulo.
|
|
148
|
+
- **Senza modulo.** Con i client che non mostrano moduli te lo propone l'agente quando ha finito il compito, una volta per sessione; se lavora da più di 30 minuti, il server lo ricorda al modello una volta. `rate_agent` prima mostra l'anteprima di ciò che parte e un codice valido 10 minuti; il modello te la mostra e invia solo con il codice, esattamente quel contenuto.
|
|
149
|
+
- Puoi anche chiederlo tu («valuta AISA-02»), o votare dal pannello (`--panel`), nella sezione «Valuta gli agenti».
|
|
150
|
+
- **Cosa parte.** Id dell'agente, voto, commento, se permetti di pubblicare il commento sul sito (spento di default), versione del pacchetto e un codice casuale della valutazione. Niente compito, file, percorsi o nome del progetto, niente account. Nel commento non scrivere nomi, dati personali o parti del progetto.
|
|
151
|
+
- **Sul sito.** Ogni agente con almeno 5 voti mostra media, numero e distribuzione dei voti, e c'è una classifica quando almeno 5 agenti superano la soglia. Un commento compare solo se hai permesso di pubblicarlo e dopo l'approvazione (criteri nelle [note legali](https://agentrica.vercel.app/note-legali#valutazioni)), con il voto e il mese.
|
|
152
|
+
- **Dopo l'invio** ricevi il codice della valutazione: con quello puoi chiedere di cancellarla o di non pubblicare il commento. Un agente si valuta una volta per sessione e una volta al giorno dalla stessa rete.
|
|
153
|
+
- **Se l'invio non riesce** (offline, servizio giù) il tool lo dice e il lavoro continua; il voto non resta salvato da nessuna parte.
|
|
154
|
+
- **Per non avere il tool**, il modulo né le proposte, aggiungi `--no-ratings` al comando: il server non si collega più ad Agentrica.
|
|
155
|
+
|
|
156
|
+
Come trattiamo le valutazioni: [note legali](https://agentrica.vercel.app/note-legali#valutazioni).
|
|
90
157
|
|
|
91
158
|
## Pannello locale
|
|
92
159
|
|
|
93
160
|
Con `--panel` il server apre anche una pagina sul tuo computer da cui segui il progetto e prendi le scelte che l'agente ti chiede, invece di rispondere nel terminale:
|
|
94
161
|
|
|
95
162
|
```sh
|
|
96
|
-
|
|
163
|
+
npx -y @agentrica/mcp@0.6.0 install --panel
|
|
97
164
|
```
|
|
98
165
|
|
|
99
166
|
Poi chiedi all'agente di aprire il pannello (tool `open_panel`): la pagina si apre nel browser. Ha tre pagine, con il menu in alto che conta le scelte in attesa e i rilievi:
|
|
100
167
|
|
|
101
|
-
- **Sessione**: le scelte da prendere (*Da decidere*), con le opzioni e le motivazioni, la cui risposta, con una nota facoltativa, torna all'agente; accanto, gli agenti di Agentrica chiamati in questa sessione (*Agenti in uso*), con l'inizio del compito;
|
|
168
|
+
- **Sessione**: le scelte da prendere (*Da decidere*), con le opzioni e le motivazioni, la cui risposta, con una nota facoltativa, torna all'agente; accanto, gli agenti di Agentrica chiamati in questa sessione (*Agenti in uso*), con il reparto e l'inizio del compito;
|
|
102
169
|
- **Piano**: la fase in corso con backlog e criteri di accettazione, e tutte le fasi del progetto;
|
|
103
170
|
- **Rilievi**: i rilievi aperti delle fasi e quelli degli audit, per priorità e reparto.
|
|
104
171
|
|
|
@@ -111,7 +178,7 @@ Con il pannello il modello ha due tool in più:
|
|
|
111
178
|
|
|
112
179
|
Se la pagina non è aperta, `ask_user` la apre. Il client aspetta la risposta finché il server manda notifiche di avanzamento (fino a 4 ore; 25 minuti con un client che non le chiede), poi l'agente chiede nel terminale. Le domande del client, come i permessi dei tool, restano nel client.
|
|
113
180
|
|
|
114
|
-
**Cosa cambia con `--panel`.** Il server apre una porta casuale solo su `127.0.0.1
|
|
181
|
+
**Cosa cambia con `--panel`.** Il server apre una porta casuale solo su `127.0.0.1` (se c'è una versione nuova, la pagina lo dice in alto), legge `plan/`, `audit/` e lo stato di git (`git status`) della cartella del progetto e tiene in memoria le ultime 20 chiamate agli agenti. Non scrive file e non manda dati fuori dal computer, salvo le valutazioni che invii dalla pagina. La pagina si apre solo con il token casuale contenuto nell'URL, che vale per quella sessione; le richieste da altri siti o con un altro `Host` sono rifiutate. Il permission model di Node consigliato sopra non si usa con `--panel`, che ha bisogno della rete locale e di `git`.
|
|
115
182
|
|
|
116
183
|
**Formato di `plan/` e `audit/`.** Il pannello legge il formato dei piani creati da `init`, lo stesso del [`plan/`](https://github.com/flgisimone/agentrica/tree/main/plan) e dell'[`audit/`](https://github.com/flgisimone/agentrica/tree/main/audit) di Agentrica; se qualcosa manca, la pagina dice cosa.
|
|
117
184
|
|
|
@@ -124,7 +191,7 @@ Se la pagina non è aperta, `ask_user` la apre. Il client aspetta la risposta fi
|
|
|
124
191
|
`init` crea un progetto con il metodo di lavoro di Agentrica, pronto per Claude Code:
|
|
125
192
|
|
|
126
193
|
```sh
|
|
127
|
-
npx -y @agentrica/mcp@0.
|
|
194
|
+
npx -y @agentrica/mcp@0.6.0 init mio-progetto --name "Mio progetto"
|
|
128
195
|
```
|
|
129
196
|
|
|
130
197
|
Senza cartella usa quella corrente; senza `--name` il nome è quello della cartella. Scrive:
|
|
@@ -133,7 +200,7 @@ Senza cartella usa quella corrente; senza `--name` il nome è quello della carte
|
|
|
133
200
|
- `plan/` con `README.md` (decisioni, glossario, fasi) e `00-base.md`, la fase F0 da cui si parte; `audit/` e `docs/`;
|
|
134
201
|
- `agents/` e `.claude/agents/`: i 56 ruoli di questa versione e un subagent per ruolo, con il nome del progetto;
|
|
135
202
|
- `.github/workflows/ci.yml` (`npm run verify` e `verify:e2e`, saltati finché F0 non li crea), `.gitignore`, `.nvmrc`, `.env.example`;
|
|
136
|
-
- `.mcp.json` con questo server a versione esatta e `--panel`, così il pannello legge subito il piano.
|
|
203
|
+
- `.mcp.json` con questo server a versione esatta e `--panel`, così il pannello legge subito il piano (su Windows con `cmd /c npx`).
|
|
137
204
|
|
|
138
205
|
Se anche un solo file esiste già, `init` non scrive nulla e dice quali sono. Fuori da un repository git fa il primo commit su `main` e lascia attivo `develop`; dentro un repository non fa commit. Poi apri Claude Code nella cartella e chiedi di aprire la fase F0. `init` è l'unico comando che scrive file: il server resta in sola lettura. Prende il posto di agentic-starter, che non si aggiorna più.
|
|
139
206
|
|
|
@@ -149,22 +216,27 @@ Tre agenti provati il 2026-11-15 su tre piccoli progetti con difetti piantati e
|
|
|
149
216
|
|
|
150
217
|
Limiti: i difetti sono pochi, noti e abbastanza evidenti; un solo modello e una sola esecuzione per caso; un risultato del genere non dice come va un agente su un progetto grande. Progetti, difetti attesi, regole di conteggio e rapporti completi degli agenti sono in [`examples/`](https://github.com/flgisimone/agentrica/tree/main/examples): puoi ripetere le prove.
|
|
151
218
|
|
|
152
|
-
##
|
|
219
|
+
## Aggiornare e disinstallare
|
|
220
|
+
|
|
221
|
+
Il testo degli agenti viene dai file di `agents/` della versione installata. Quando esce una versione nuova il server te lo dice una volta per sessione, nella risposta di un tool e nel pannello, con il comando giusto per come l'hai installato. Gli id e i nomi in codice non cambiano.
|
|
222
|
+
|
|
223
|
+
- **Installato con `install`**: rilancia `install` con la versione nuova, es. `npx -y @agentrica/mcp@<versione> install`, poi riavvia Claude Code.
|
|
224
|
+
- **Con `add` o `init`**: rilancia `add` con la versione nuova, o cambia la versione nel comando del server o nel `.mcp.json`, poi riavvia il client.
|
|
225
|
+
|
|
226
|
+
Per disinstallare:
|
|
227
|
+
|
|
228
|
+
```sh
|
|
229
|
+
claude mcp remove agentrica --scope user
|
|
230
|
+
npm uninstall -g @agentrica/mcp
|
|
231
|
+
```
|
|
153
232
|
|
|
154
|
-
Il
|
|
233
|
+
Il secondo comando serve solo se avevi usato `install`; con `add --project` o `--local` usa quell'ambito al posto di `user`.
|
|
155
234
|
|
|
156
235
|
Lo stesso catalogo si legge anche da codice, senza avviare il server: `import { loadCatalog } from "@agentrica/mcp/catalog"` restituisce reparti e agenti (con i tipi `Department` e `Agent`) dagli `agents/` del pacchetto. È ciò che usa il sito di Agentrica.
|
|
157
236
|
|
|
158
237
|
## Versioni
|
|
159
238
|
|
|
160
|
-
|
|
161
|
-
- **0.3.3**: export `@agentrica/mcp/catalog` per leggere reparti e agenti da codice (lo usa il sito, ora in un repository a parte); agenti e comportamento del server invariati.
|
|
162
|
-
- **0.3.2**: pannello in tre pagine (Sessione, Piano, Rilievi) con menu e contatori delle scelte in attesa e dei rilievi; agenti e comportamento del server invariati.
|
|
163
|
-
- **0.3.1**: pannello che nasconde i rilievi chiusi e conta a parte i file nuovi; id del tool `agente` limitato alle sigle dei reparti; regole comuni con una scala di gravità condivisa (P0–P3) e una scala per il reparto software.
|
|
164
|
-
- **0.3.0**: pannello locale con `--panel`: fasi, backlog, rilievi, agenti in uso e scelte da prendere dalla pagina (tool `open_panel` e `ask_user`). Senza `--panel` nulla cambia.
|
|
165
|
-
- **0.2.1**: nome `io.github.flgisimone/agentrica` per il registro MCP ufficiale; agenti e comportamento invariati.
|
|
166
|
-
- **0.2.0**: argomento `--agents` per caricare solo una squadra di agenti o reparti; con un progetto vuoto, o senza ciò che il ruolo deve esaminare, l'agente lo dice e propone i primi passi da confermare, senza inventare rilievi.
|
|
167
|
-
- **0.1.0**: prima versione pubblicata. 56 agenti in cinque reparti, un prompt per agente e i tool `elenca_agenti` e `agente`.
|
|
239
|
+
Le novità di ogni versione, con la data, sono in [CHANGELOG.md](https://github.com/flgisimone/agentrica/blob/main/packages/mcp/CHANGELOG.md). La 0.6.0 cambia il nome dei prompt (`aisa-02` diventa `aisa-02-software`).
|
|
168
240
|
|
|
169
241
|
## Licenza
|
|
170
242
|
|
|
@@ -2,6 +2,8 @@ export type DepartmentCode = "AIBPD" | "AICA" | "AIPCA" | "AISA" | "AIWDA";
|
|
|
2
2
|
export interface DepartmentInfo {
|
|
3
3
|
code: DepartmentCode;
|
|
4
4
|
name: string;
|
|
5
|
+
/** Nome breve, nel nome dei prompt dell'MCP («aisa-02-software») e nel pannello: non cambia dopo la pubblicazione (0.6.0). */
|
|
6
|
+
short: string;
|
|
5
7
|
/** Cartella in agents/. */
|
|
6
8
|
folder: string;
|
|
7
9
|
/** Cosa fa il reparto, in una riga. */
|
|
@@ -4,6 +4,7 @@ export const DEPARTMENTS = [
|
|
|
4
4
|
{
|
|
5
5
|
code: "AIBPD",
|
|
6
6
|
name: "AI Business & Product Development",
|
|
7
|
+
short: "Business",
|
|
7
8
|
folder: "ai_business_product_development_agency",
|
|
8
9
|
summary: "Obiettivi, requisiti, priorità, roadmap, business case e mercato.",
|
|
9
10
|
stars: ["ALDERAMIN", "PROCYON", "ALPHARD", "HAMAL", "ALGIEBA", "DIPHDA", "MENKENT", "MIRACH", "ALPHERATZ", "RASALHAGUE", "KOCHAB", "DENEBOLA"],
|
|
@@ -11,6 +12,7 @@ export const DEPARTMENTS = [
|
|
|
11
12
|
{
|
|
12
13
|
code: "AICA",
|
|
13
14
|
name: "AI Cybersecurity",
|
|
15
|
+
short: "Cybersecurity",
|
|
14
16
|
folder: "ai_cybersecurity_agency",
|
|
15
17
|
summary: "Threat model, configurazioni, accessi, vulnerabilità e risposta agli incidenti.",
|
|
16
18
|
stars: ["VEGA", "RIGEL", "BETELGEUSE", "ALNILAM", "ALNITAK", "MINTAKA", "SAIPH", "ELNATH", "WEZEN", "SARGAS", "ATRIA", "NUNKI"],
|
|
@@ -18,6 +20,7 @@ export const DEPARTMENTS = [
|
|
|
18
20
|
{
|
|
19
21
|
code: "AIPCA",
|
|
20
22
|
name: "AI Privacy & Compliance",
|
|
23
|
+
short: "Privacy",
|
|
21
24
|
folder: "ai_privacy_compliance_agency",
|
|
22
25
|
summary: "GDPR, basi giuridiche, conservazione dei dati, fornitori e DPIA.",
|
|
23
26
|
stars: ["ARCTURUS", "ALIOTH", "DUBHE", "ALKAID", "MIZAR", "MERAK", "ALCOR", "PHECDA", "MEGREZ", "THUBAN"],
|
|
@@ -25,6 +28,7 @@ export const DEPARTMENTS = [
|
|
|
25
28
|
{
|
|
26
29
|
code: "AISA",
|
|
27
30
|
name: "AI Software",
|
|
31
|
+
short: "Software",
|
|
28
32
|
folder: "ai_software_agency",
|
|
29
33
|
summary: "Analisi, architettura, sviluppo, test, sicurezza applicativa e revisione del codice.",
|
|
30
34
|
stars: ["SIRIUS", "ALTAIR", "ALDEBARAN", "ANTARES", "SPICA", "POLLUX", "FOMALHAUT", "DENEB", "REGULUS", "CASTOR", "BELLATRIX", "MIRFAK"],
|
|
@@ -32,6 +36,7 @@ export const DEPARTMENTS = [
|
|
|
32
36
|
{
|
|
33
37
|
code: "AIWDA",
|
|
34
38
|
name: "AI Web Design",
|
|
39
|
+
short: "Design",
|
|
35
40
|
folder: "ai_web_design_agency",
|
|
36
41
|
summary: "Ricerca UX, interfacce, architettura informativa, design system, accessibilità e testi.",
|
|
37
42
|
stars: ["CANOPUS", "ACHERNAR", "HADAR", "ACRUX", "MIMOSA", "ADHARA", "SHAULA", "GACRUX", "ALNAIR", "AVIOR"],
|