Italiano | English

---

MCP Suite

Una suite completa di 22 server MCP (Model Context Protocol) per la produttivita dello sviluppatore.

MCP Suite e un monorepo TypeScript che fornisce strumenti intelligenti per ogni aspetto del ciclo di vita dello sviluppo software: dalla gestione del codice al project management Scrum/Agile, dall'economia dei progetti alle utility quotidiane. Tutti i server comunicano tra loro tramite un sistema di eventi tipizzato.

---

Panoramica

Dato	Valore
Server MCP	22
Tool totali	85+
Pacchetti condivisi	6
Eventi tipizzati	29
Linguaggio	TypeScript
SDK	@modelcontextprotocol/sdk v1.x
Storage	SQLite (via better-sqlite3)
Trasporto	STDIO (compatibile Claude Desktop, Cursor, VS Code)
Build	pnpm workspaces + Turborepo

---

Architettura

                    +------------------+
                    |   Claude Desktop |
                    |   Cursor / IDE   |
                    +--------+---------+
                             |
                        STDIO Transport
                             |
              +--------------+--------------+
              |                             |
    +---------v---------+       +-----------v-----------+
    |   MCP Server #1   |       |    MCP Server #2      |
    |   (scrum-board)   |       |    (time-tracking)    |
    +---------+---------+       +-----------+-----------+
              |                             |
              +---------- EventBus ---------+
              |         (pub/sub)           |
              v                             v
    +--------------------+       +--------------------+
    |    SQLite DB       |       |    SQLite DB       |
    |  scrum-board.db    |       |  time-tracking.db  |
    +--------------------+       +--------------------+

Ogni server e indipendente e puo essere avviato singolarmente. Quando condividono lo stesso EventBus, collaborano automaticamente scambiandosi eventi tipizzati.

---

I 22 Server

Produttivita e Codice

Server	Tool	Descrizione
code-review	3	Analisi diff, complessita ciclomatica, suggerimenti di miglioramento
dependency-manager	3	Vulnerabilita, dipendenze inutilizzate, audit licenze
project-scaffolding	3	Generazione progetti da template (Node.js, Express, React, MCP)

DevOps e Infrastruttura

Server	Tool	Descrizione
docker-compose	4	Parsing YAML, analisi Dockerfile, generazione compose
log-analyzer	4	Analisi log, pattern di errore, tail, summary
cicd-monitor	4	Monitoraggio GitHub Actions, log, test flaky

Database e Dati

Server	Tool	Descrizione
db-schema-explorer	4	Esplorazione schema SQLite, suggerimento indici, ERD Mermaid
data-mock-generator	4	Generazione dati mock in JSON, CSV con 16 generatori

Documentazione

Server	Tool	Descrizione
api-documentation	3	Estrazione endpoint Express/NestJS, generazione OpenAPI 3.0
codebase-knowledge	4	Ricerca codice, analisi moduli, mappa architettura, grafo dipendenze

Testing e Qualita

Server	Tool	Descrizione
test-generator	3	Generazione test unitari, edge case, analisi coverage
performance-profiler	3	Analisi bundle, bottleneck, benchmark comparativi

Utility

Server	Tool	Descrizione
regex-builder	5	Costruzione, test, spiegazione, ottimizzazione regex
http-client	3	Richieste HTTP, confronto risposte, generazione curl
snippet-manager	5	Gestione snippet con tag, ricerca, storage SQLite

Project Management (Scrum/Agile)

Server	Tool	Descrizione
scrum-board	7	Sprint, user story, task, board Kanban
agile-metrics	4	Velocity, burndown, cycle time, forecast Monte Carlo
time-tracking	4	Timer, log manuale, timesheet
project-economics	4	Budget, costi, forecast burn rate
retrospective-manager	5	Retro (mad-sad-glad, 4Ls, start-stop-continue), voti, action item

Comunicazione

Server	Tool	Descrizione
standup-notes	3	Standup giornalieri, storico, report di stato
environment-manager	5	Gestione file .env, confronto, validazione, template

---

Quick Start

Prerequisiti

• Node.js >= 20.0.0
• pnpm >= 9.0.0

Installazione

# Clona il repository
git clone https://github.com/user/mcp-suite.git
cd mcp-suite

# Installa le dipendenze
pnpm install

# Build di tutti i pacchetti e server
pnpm build

Configurazione Claude Desktop

Aggiungi uno o piu server al file di configurazione di Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "scrum-board": {
      "command": "node",
      "args": ["/percorso/a/mcp-suite/servers/scrum-board/dist/index.js"]
    },
    "time-tracking": {
      "command": "node",
      "args": ["/percorso/a/mcp-suite/servers/time-tracking/dist/index.js"]
    },
    "code-review": {
      "command": "node",
      "args": ["/percorso/a/mcp-suite/servers/code-review/dist/index.js"]
    }
  }
}

Avvio manuale di un singolo server

# Avvia un server specifico
node servers/scrum-board/dist/index.js

# Oppure usa la CLI
npx @mcp-suite/cli start scrum-board

---

Struttura del Progetto

mcp-suite/
├── packages/                  # Librerie condivise
│   ├── core/                  # Factory server, tipi, config, logger
│   ├── event-bus/             # Pub/sub tipizzato con 29 eventi
│   ├── client-manager/        # Chiamate server-to-server
│   ├── database/              # Wrapper SQLite + migrazioni
│   ├── testing/               # Mock transport e event bus per test
│   └── cli/                   # CLI: start, list, status
│
├── servers/                   # 22 MCP Server
│   ├── scrum-board/           # Hub centrale project management
│   ├── time-tracking/         # Tracciamento tempo
│   ├── ...                    # (altri 20 server)
│   └── environment-manager/   # Gestione .env
│
├── docs/                      # Documentazione completa
│   ├── it/                    # Documentazione in italiano
│   └── en/                    # Documentation in English
├── pnpm-workspace.yaml        # Configurazione workspace
├── turbo.json                 # Build orchestration
└── tsconfig.base.json         # Config TypeScript condivisa

Ogni server segue una struttura uniforme:

servers/<nome>/
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts               # Entry point
    ├── server.ts              # Factory e registrazione tool
    ├── tools/                 # Un file per tool
    ├── services/              # Business logic e store (opzionale)
    └── collaboration.ts       # Event handler cross-server (opzionale)

---

Collaborazione Inter-Server

I server comunicano attraverso un EventBus tipizzato con 29 eventi definiti. Quando un server esegue un'azione significativa (es. creazione sprint, log tempo), pubblica un evento che altri server possono sottoscrivere.

scrum-board                          agile-metrics
     |                                     |
     |-- scrum:sprint-completed ---------> |  (aggiorna velocity)
     |-- scrum:task-updated -------------> |  (calcola cycle time)
     |                                     |
time-tracking                      project-economics
     |                                     |
     |-- time:entry-logged --------------> |  (converte in costo)

Vedi docs/it/14-collaborazione-inter-server/ per la matrice completa.

---

Comandi Utili

# Build completo
pnpm build

# Build solo pacchetti condivisi
pnpm build:packages

# Build solo server
pnpm build:servers

# Build un singolo server
pnpm --filter @mcp-suite/server-scrum-board build

# Type check
pnpm typecheck

# Formattazione codice
pnpm format

# Pulizia
pnpm clean

---

Tecnologie

• TypeScript - Tipizzazione statica end-to-end
• Model Context Protocol (MCP) - Standard aperto di Anthropic per la comunicazione tool-AI
• pnpm - Package manager veloce con supporto workspace
• Turborepo - Build orchestration con caching
• SQLite (better-sqlite3) - Storage locale senza configurazione
• Zod - Validazione schema a runtime
• Node.js EventEmitter - Event bus in-process

---

Documentazione

La documentazione completa e disponibile in due lingue:

Italiano (docs/it/)

Sezione	Contenuto
01 - Introduzione a MCP	Teoria del protocollo, concetti fondamentali
02 - Architettura	Design del monorepo, pattern, decisioni
03 - Installazione	Guida passo-passo per Windows, macOS, Linux
04 - Configurazione	Claude Desktop, variabili ambiente, trasporti
05 - Pacchetti Condivisi	Core, EventBus, Database, Testing, CLI
06 - Server Produttivita	code-review, dependency-manager, project-scaffolding
07 - Server DevOps	docker-compose, log-analyzer, cicd-monitor
08 - Server Database	db-schema-explorer, data-mock-generator
09 - Server Documentazione	api-documentation, codebase-knowledge
10 - Server Testing	test-generator, performance-profiler
11 - Server Utility	regex-builder, http-client, snippet-manager
12 - Server Project Management	scrum-board, agile-metrics, time-tracking, economics, retro
13 - Server Comunicazione	standup-notes, environment-manager
14 - Collaborazione Inter-Server	EventBus, matrice eventi, pattern
15 - Sviluppi Futuri	Roadmap, contributi, idee
16 - Guida Creazione Server/Client	Tutorial completo dalla teoria alla produzione

English (docs/en/)

Section	Content
01 - Introduction to MCP	Protocol theory, core concepts
02 - Architecture	Monorepo design, patterns, decisions
03 - Installation	Step-by-step guide for Windows, macOS, Linux
04 - Configuration	Claude Desktop, environment variables, transports
05 - Shared Packages	Core, EventBus, Database, Testing, CLI
06 - Productivity Servers	code-review, dependency-manager, project-scaffolding
07 - DevOps Servers	docker-compose, log-analyzer, cicd-monitor
08 - Database Servers	db-schema-explorer, data-mock-generator
09 - Documentation Servers	api-documentation, codebase-knowledge
10 - Testing Servers	test-generator, performance-profiler
11 - Utility Servers	regex-builder, http-client, snippet-manager
12 - Project Management Servers	scrum-board, agile-metrics, time-tracking, economics, retro
13 - Communication Servers	standup-notes, environment-manager
14 - Inter-Server Collaboration	EventBus, event matrix, patterns
15 - Future Developments	Roadmap, contributions, ideas
16 - Server/Client Creation Guide	Complete tutorial from theory to production

---

Licenza

Questo progetto e distribuito sotto la GNU Affero General Public License v3.0 (AGPL-3.0).

Questo significa che:

• Puoi usare, modificare e distribuire liberamente questo software
• Qualsiasi modifica o lavoro derivato deve essere rilasciato sotto la stessa licenza AGPL-3.0
• Se esegui una versione modificata come servizio di rete (SaaS), devi rendere disponibile il codice sorgente agli utenti di quel servizio
• Devi mantenere le note di copyright e licenza in tutte le copie

Vedi il file LICENSE per il testo completo della licenza.

---

Contribuire

I contributi sono benvenuti! Questo progetto cresce grazie alla community.

Setup ambiente di sviluppo

# Fai fork e clona il repository
git clone https://github.com/<tuo-utente>/mcp-suite.git
cd mcp-suite

# Installa le dipendenze
pnpm install

# Esegui la build completa
pnpm build

# Esegui i test
pnpm test

Come contribuire

• Segnalare bug: apri una issue con una descrizione chiara, i passi per riprodurre il problema e il comportamento atteso
• Proporre feature: apri una issue descrivendo la funzionalita, il caso d'uso e l'approccio proposto
• Inviare codice: segui il processo PR descritto sotto

Processo Pull Request

1. Fai fork del repository
2. Crea un branch dal master:
   • feature/nome-feature per nuove funzionalita
   • fix/nome-bug per bug fix
3. Scrivi codice seguendo le convenzioni del progetto
4. Aggiungi o aggiorna i test per le tue modifiche
5. Assicurati che pnpm build e pnpm test passino
6. Committa con messaggi chiari e descrittivi
7. Pusha il branch e apri una Pull Request

Convenzioni codice

• TypeScript strict mode ovunque
• Ogni server segue la struttura uniforme: index.ts, server.ts, tools/, services/, collaboration.ts
• Pattern EventBus: parametro opzionale eventBus?: EventBus, pubblicazione fire-and-forget con eventBus?.publish()
• Pattern ClientManager: parametro opzionale clientManager?: McpClientManager per chiamate cross-server
• Validazione input con Zod
• Storage con SQLite via better-sqlite3

Aggiungere un nuovo server

Consulta la Guida alla Creazione di Server/Client per un tutorial completo dalla teoria alla produzione.

Codice di condotta

• Tratta tutti i partecipanti con rispetto e professionalita
• Collaborazione costruttiva: feedback orientato al miglioramento
• Nessuna discriminazione di alcun tipo
• Mantieni le discussioni focalizzate sul progetto

Nota sulla licenza

Inviando una Pull Request, accetti che i tuoi contributi saranno distribuiti sotto la licenza AGPL-3.0, alle stesse condizioni del progetto principale.

---

---

MCP Suite (EN)

A complete suite of 22 MCP (Model Context Protocol) servers for developer productivity.

MCP Suite is a TypeScript monorepo that provides intelligent tools for every aspect of the software development lifecycle: from code management to Scrum/Agile project management, from project economics to everyday utilities. All servers communicate with each other through a typed event system.

---

Overview

Info	Value
MCP Servers	22
Total Tools	85+
Shared Packages	6
Typed Events	29
Language	TypeScript
SDK	@modelcontextprotocol/sdk v1.x
Storage	SQLite (via better-sqlite3)
Transport	STDIO (compatible with Claude Desktop, Cursor, VS Code)
Build	pnpm workspaces + Turborepo

---

Architecture

                    +------------------+
                    |   Claude Desktop |
                    |   Cursor / IDE   |
                    +--------+---------+
                             |
                        STDIO Transport
                             |
              +--------------+--------------+
              |                             |
    +---------v---------+       +-----------v-----------+
    |   MCP Server #1   |       |    MCP Server #2      |
    |   (scrum-board)   |       |    (time-tracking)    |
    +---------+---------+       +-----------+-----------+
              |                             |
              +---------- EventBus ---------+
              |         (pub/sub)           |
              v                             v
    +--------------------+       +--------------------+
    |    SQLite DB       |       |    SQLite DB       |
    |  scrum-board.db    |       |  time-tracking.db  |
    +--------------------+       +--------------------+

Each server is independent and can be started individually. When they share the same EventBus, they automatically collaborate by exchanging typed events.

---

The 22 Servers

Productivity & Code

Server	Tools	Description
code-review	3	Diff analysis, cyclomatic complexity, improvement suggestions
dependency-manager	3	Vulnerabilities, unused dependencies, license audit
project-scaffolding	3	Project generation from templates (Node.js, Express, React, MCP)

DevOps & Infrastructure

Server	Tools	Description
docker-compose	4	YAML parsing, Dockerfile analysis, compose generation
log-analyzer	4	Log analysis, error patterns, tail, summary
cicd-monitor	4	GitHub Actions monitoring, logs, flaky tests

Database & Data

Server	Tools	Description
db-schema-explorer	4	SQLite schema exploration, index suggestions, Mermaid ERD
data-mock-generator	4	Mock data generation in JSON, CSV with 16 generators

Documentation

Server	Tools	Description
api-documentation	3	Express/NestJS endpoint extraction, OpenAPI 3.0 generation
codebase-knowledge	4	Code search, module analysis, architecture map, dependency graph

Testing & Quality

Server	Tools	Description
test-generator	3	Unit test generation, edge cases, coverage analysis
performance-profiler	3	Bundle analysis, bottlenecks, comparative benchmarks

Utility

Server	Tools	Description
regex-builder	5	Build, test, explain, optimize regex
http-client	3	HTTP requests, response comparison, curl generation
snippet-manager	5	Snippet management with tags, search, SQLite storage

Project Management (Scrum/Agile)

Server	Tools	Description
scrum-board	7	Sprints, user stories, tasks, Kanban board
agile-metrics	4	Velocity, burndown, cycle time, Monte Carlo forecast
time-tracking	4	Timer, manual logging, timesheet
project-economics	4	Budget, costs, burn rate forecast
retrospective-manager	5	Retros (mad-sad-glad, 4Ls, start-stop-continue), votes, action items

Communication

Server	Tools	Description
standup-notes	3	Daily standups, history, status reports
environment-manager	5	.env file management, comparison, validation, templates

---

Quick Start

Prerequisites

• Node.js >= 20.0.0
• pnpm >= 9.0.0

Installation

# Clone the repository
git clone https://github.com/user/mcp-suite.git
cd mcp-suite

# Install dependencies
pnpm install

# Build all packages and servers
pnpm build

Claude Desktop Configuration

Add one or more servers to the Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "scrum-board": {
      "command": "node",
      "args": ["/path/to/mcp-suite/servers/scrum-board/dist/index.js"]
    },
    "time-tracking": {
      "command": "node",
      "args": ["/path/to/mcp-suite/servers/time-tracking/dist/index.js"]
    },
    "code-review": {
      "command": "node",
      "args": ["/path/to/mcp-suite/servers/code-review/dist/index.js"]
    }
  }
}

Manually Starting a Single Server

# Start a specific server
node servers/scrum-board/dist/index.js

# Or use the CLI
npx @mcp-suite/cli start scrum-board

---

Project Structure

mcp-suite/
├── packages/                  # Shared libraries
│   ├── core/                  # Server factory, types, config, logger
│   ├── event-bus/             # Typed pub/sub with 29 events
│   ├── client-manager/        # Server-to-server calls
│   ├── database/              # SQLite wrapper + migrations
│   ├── testing/               # Mock transport and event bus for tests
│   └── cli/                   # CLI: start, list, status
│
├── servers/                   # 22 MCP Servers
│   ├── scrum-board/           # Central project management hub
│   ├── time-tracking/         # Time tracking
│   ├── ...                    # (20 more servers)
│   └── environment-manager/   # .env management
│
├── docs/                      # Full documentation
│   ├── it/                    # Documentazione in italiano
│   └── en/                    # Documentation in English
├── pnpm-workspace.yaml        # Workspace configuration
├── turbo.json                 # Build orchestration
└── tsconfig.base.json         # Shared TypeScript config

Each server follows a uniform structure:

servers/<name>/
├── package.json
├── tsconfig.json
└── src/
    ├── index.ts               # Entry point
    ├── server.ts              # Factory and tool registration
    ├── tools/                 # One file per tool
    ├── services/              # Business logic and store (optional)
    └── collaboration.ts       # Cross-server event handlers (optional)

---

Inter-Server Collaboration

Servers communicate through a typed EventBus with 29 defined events. When a server performs a significant action (e.g., sprint creation, time logging), it publishes an event that other servers can subscribe to.

scrum-board                          agile-metrics
     |                                     |
     |-- scrum:sprint-completed ---------> |  (updates velocity)
     |-- scrum:task-updated -------------> |  (calculates cycle time)
     |                                     |
time-tracking                      project-economics
     |                                     |
     |-- time:entry-logged --------------> |  (converts to cost)

See docs/en/14-inter-server-collaboration/ for the complete matrix.

---

Useful Commands

# Full build
pnpm build

# Build shared packages only
pnpm build:packages

# Build servers only
pnpm build:servers

# Build a single server
pnpm --filter @mcp-suite/server-scrum-board build

# Type check
pnpm typecheck

# Code formatting
pnpm format

# Clean
pnpm clean

---

Technologies

• TypeScript - End-to-end static typing
• Model Context Protocol (MCP) - Anthropic's open standard for tool-AI communication
• pnpm - Fast package manager with workspace support
• Turborepo - Build orchestration with caching
• SQLite (better-sqlite3) - Zero-configuration local storage
• Zod - Runtime schema validation
• Node.js EventEmitter - In-process event bus

---

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

This means:

• You can freely use, modify, and distribute this software
• Any modifications or derivative works must be released under the same AGPL-3.0 license
• If you run a modified version as a network service (SaaS), you must make the source code available to users of that service
• You must retain copyright and license notices in all copies

See the LICENSE file for the full license text.

---

Contributing

Contributions are welcome! This project grows thanks to its community.

Development setup

# Fork and clone the repository
git clone https://github.com/<your-username>/mcp-suite.git
cd mcp-suite

# Install dependencies
pnpm install

# Run full build
pnpm build

# Run tests
pnpm test

How to contribute

• Report bugs: open an issue with a clear description, steps to reproduce, and expected behavior
• Propose features: open an issue describing the feature, use case, and proposed approach
• Submit code: follow the PR process below

Pull Request process

1. Fork the repository
2. Create a branch from master:
   • feature/feature-name for new features
   • fix/bug-name for bug fixes
3. Write code following the project conventions
4. Add or update tests for your changes
5. Make sure pnpm build and pnpm test pass
6. Commit with clear, descriptive messages
7. Push the branch and open a Pull Request

Code conventions

• TypeScript strict mode everywhere
• Each server follows the uniform structure: index.ts, server.ts, tools/, services/, collaboration.ts
• EventBus pattern: optional eventBus?: EventBus parameter, fire-and-forget publishing with eventBus?.publish()
• ClientManager pattern: optional clientManager?: McpClientManager parameter for cross-server calls
• Input validation with Zod
• Storage with SQLite via better-sqlite3

Adding a new server

See the Server/Client Creation Guide for a complete tutorial from theory to production.

Code of conduct

• Treat all participants with respect and professionalism
• Constructive collaboration: feedback oriented toward improvement
• No discrimination of any kind
• Keep discussions focused on the project

License note

By submitting a Pull Request, you agree that your contributions will be distributed under the AGPL-3.0 license, under the same terms as the main project.