Introduzione: Il Viaggio Completo
Questo e l'ultimo articolo della serie dedicata al Model Context Protocol (MCP).
In 14 articoli abbiamo percorso un cammino completo: dai fondamenti teorici del protocollo fino
all'implementazione di un ecosistema production-ready con 31 server MCP, 85+ tool, 6 pacchetti
condivisi e un sistema di testing professionale.
In questo articolo presentiamo una panoramica completa del progetto open source
Tech-MCP:
il catalogo di tutti i server organizzati per categoria, lo stack tecnologico, l'architettura
complessiva, le lezioni apprese durante lo sviluppo e come contribuire al progetto.
Cosa Imparerai in Questo Articolo
- Panoramica completa del progetto Tech-MCP con numeri e statistiche
- Catalogo di tutti i 31 server organizzati per categoria
- Stack tecnologico: TypeScript 5.7, Node.js 20+, pnpm, Turborepo, SQLite
- Architettura complessiva del monorepo e dei pacchetti condivisi
- Come contribuire al progetto su GitHub
- Roadmap e sviluppi futuri pianificati
- Lezioni apprese dalla costruzione di 31 server MCP
- Riepilogo dell'intera serie di 14 articoli
Tech-MCP in Numeri
Il progetto Tech-MCP
e il risultato di un processo di progettazione e sviluppo che ha prodotto un ecosistema MCP completo,
coprendo l'intero ciclo di vita dello sviluppo software. Ecco i numeri chiave:
Statistiche del Progetto
| Metrica |
Valore |
| Server MCP |
31 |
| Tool disponibili |
85+ |
| Pacchetti condivisi |
6 |
| Eventi tipizzati |
29 |
| Linee di codice TypeScript |
23.000+ |
| Linguaggio |
TypeScript 5.7 |
| Runtime |
Node.js 20+ |
| Build system |
Turborepo + pnpm |
| Database |
SQLite (better-sqlite3) |
| Validazione |
Zod |
| Testing |
Vitest |
| Licenza |
Open Source |
Architettura Complessiva
Tech-MCP e organizzato come un monorepo gestito con pnpm workspaces e Turborepo.
I pacchetti condivisi forniscono funzionalità trasversali, mentre i 31 server implementano
la logica di dominio specifica:
Tech-MCP/
├── packages/ # 6 Pacchetti Condivisi
│ ├── core/ # Factory, tipi condivisi, startHttpServer()
│ ├── event-bus/ # EventBus interface + LocalEventBus + 29 eventi
│ ├── client-manager/ # McpClientManager per cross-server
│ ├── database/ # BaseStore SQLite, migrazioni
│ ├── testing/ # TestHarness, MockEventBus, InMemoryTransport
│ └── cli/ # Utility CLI per gestione server
│
├── servers/ # 31 Server MCP
│ ├── scrum-board/ # Project Management
│ ├── agile-metrics/ # Project Management
│ ├── time-tracking/ # Project Management
│ ├── project-economics/ # Project Management
│ ├── retrospective-manager/ # Project Management
│ ├── code-review/ # Produttività
│ ├── dependency-manager/ # Produttività
│ ├── project-scaffolding/ # Produttività
│ ├── docker-compose/ # DevOps
│ ├── log-analyzer/ # DevOps
│ ├── cicd-monitor/ # DevOps
│ ├── db-schema-explorer/ # Database
│ ├── data-mock-generator/ # Database
│ ├── test-generator/ # Testing
│ ├── performance-profiler/ # Testing
│ ├── api-documentation/ # Documentazione
│ ├── codebase-knowledge/ # Documentazione
│ ├── regex-builder/ # Utility
│ ├── http-client/ # Utility
│ ├── snippet-manager/ # Utility
│ ├── standup-notes/ # Comunicazione
│ ├── environment-manager/ # Comunicazione
│ ├── incident-manager/ # Avanzati
│ ├── decision-log/ # Avanzati
│ ├── access-policy/ # Avanzati
│ ├── quality-gate/ # Avanzati
│ ├── workflow-orchestrator/ # Avanzati
│ ├── insight-engine/ # Avanzati
│ ├── mcp-registry/ # Avanzati
│ ├── dashboard-api/ # Avanzati
│ └── tech-radar/ # Avanzati
│
├── docs/ # Documentazione completa
├── turbo.json # Configurazione Turborepo
├── pnpm-workspace.yaml # Workspace definition
└── package.json # Root package
Catalogo Completo dei Server
I 31 server MCP sono organizzati in 9 categorie funzionali che coprono ogni aspetto del ciclo
di vita dello sviluppo software. Ogni server e indipendente ma può collaborare con gli altri
tramite EventBus e ClientManager.
Project Management (5 server)
| Server |
Tool Principali |
Descrizione |
| scrum-board |
create-sprint, add-story, update-task-status |
Gestione sprint, storie e task con board Scrum completo |
| agile-metrics |
calculate-velocity, get-burndown, cycle-time |
Metriche agili: velocity, burndown, lead time, cycle time |
| time-tracking |
start-timer, stop-timer, get-timesheet |
Tracciamento tempo con timer e report settimanali |
| project-economics |
set-budget, log-expense, get-budget-status |
Gestione budget, spese e analisi economica del progetto |
| retrospective-manager |
create-retro, add-feedback, generate-actions |
Retrospettive di sprint con feedback e azioni correttive |
Produttività (3 server)
| Server |
Tool Principali |
Descrizione |
| code-review |
analyze-diff, find-issues, suggest-improvements |
Analisi del codice con identificazione di problemi e miglioramenti |
| dependency-manager |
scan-dependencies, check-updates, audit-security |
Gestione dipendenze, aggiornamenti e audit di sicurezza |
| project-scaffolding |
generate-project, add-module, create-config |
Generazione struttura progetto e scaffold di moduli |
DevOps (3 server)
| Server |
Tool Principali |
Descrizione |
| docker-compose |
generate-compose, validate-config, optimize |
Generazione e validazione file docker-compose |
| log-analyzer |
parse-logs, find-errors, aggregate-stats |
Analisi log applicativi con pattern matching |
| cicd-monitor |
list-pipelines, get-build-status, analyze-failures |
Monitoraggio pipeline CI/CD e analisi fallimenti |
Database (2 server)
| Server |
Tool Principali |
Descrizione |
| db-schema-explorer |
list-tables, describe-table, analyze-relations |
Esplorazione schema database con analisi relazioni |
| data-mock-generator |
generate-mock-data, create-fixture, seed-database |
Generazione dati di test realistici e fixture |
Testing (2 server)
| Server |
Tool Principali |
Descrizione |
| test-generator |
generate-unit-tests, generate-integration-tests |
Generazione automatica di test unit e integration |
| performance-profiler |
profile-endpoint, find-bottlenecks, benchmark |
Profiling performance e identificazione colli di bottiglia |
Documentazione (2 server)
| Server |
Tool Principali |
Descrizione |
| api-documentation |
generate-docs, validate-openapi, create-examples |
Generazione documentazione API e validazione OpenAPI |
| codebase-knowledge |
index-codebase, search-code, explain-module |
Knowledge base del codebase con ricerca semantica |
Utility (3 server)
| Server |
Tool Principali |
Descrizione |
| regex-builder |
build-regex, test-pattern, explain-regex |
Costruzione e test espressioni regolari |
| http-client |
send-request, test-endpoint, mock-api |
Client HTTP per test API e mock di endpoint |
| snippet-manager |
save-snippet, search-snippets, get-snippet |
Gestione snippet di codice con tag e ricerca |
Comunicazione (2 server)
| Server |
Tool Principali |
Descrizione |
| standup-notes |
create-standup, list-standups, generate-summary |
Gestione daily standup con note e riepiloghi |
| environment-manager |
list-environments, compare-configs, sync-env |
Gestione ambienti di deployment e configurazioni |
Avanzati (9 server)
| Server |
Tool Principali |
Descrizione |
| incident-manager |
create-incident, update-status, post-mortem |
Gestione incidenti con severity e post-mortem |
| decision-log |
log-decision, list-decisions, search-context |
Registro decisioni architetturali (ADR) |
| access-policy |
define-policy, check-access, audit-permissions |
Gestione policy di accesso e audit permessi |
| quality-gate |
define-gate, evaluate-quality, get-report |
Quality gate con metriche e soglie configurabili |
| workflow-orchestrator |
create-workflow, execute-step, get-status |
Orchestrazione workflow multi-step |
| insight-engine |
health-dashboard, cross-project-analysis |
Analisi cross-server con aggregazione dati |
| mcp-registry |
register-server, list-servers, discover-tools |
Registry dei server MCP con discovery automatico |
| dashboard-api |
create-dashboard, add-widget, get-metrics |
Dashboard API per visualizzazione metriche |
| tech-radar |
add-technology, evaluate-adoption, get-radar |
Technology radar per tracciare adozione tecnologie |
Stack Tecnologico
Lo stack tecnologico di Tech-MCP e stato scelto per massimizzare la type-safety, la velocità
di sviluppo e la manutenibilità a lungo termine:
Tecnologie Utilizzate
| Componente |
Tecnologia |
Ruolo |
| Linguaggio |
TypeScript 5.7 |
Type-safety, interfacce, generics |
| Runtime |
Node.js 20+ |
ES modules nativi, performance |
| Package Manager |
pnpm 9+ |
Workspace monorepo, linking efficiente |
| Build System |
Turborepo |
Build paralleli, caching, task orchestration |
| Database |
SQLite (better-sqlite3) |
Persistenza locale, zero configurazione |
| Validazione |
Zod |
Schema validation, type inference |
| MCP SDK |
@modelcontextprotocol/sdk |
Protocollo MCP ufficiale |
| Testing |
Vitest |
Unit test, integration test, mocking |
| Transport |
STDIO + Streamable HTTP |
Comunicazione locale e remota |
I 6 Pacchetti Condivisi
I pacchetti condivisi forniscono le fondamenta su cui tutti i 31 server sono costruiti.
Ogni pacchetto e pubblicato internamente nel monorepo e consumato dai server tramite
workspace:*:
Pacchetti del Monorepo
| Pacchetto |
Responsabilità |
Export Principali |
| @mcp-suite/core |
Factory server, tipi condivisi, HTTP server |
startHttpServer(), tipi comuni |
| @mcp-suite/event-bus |
Sistema eventi tipizzati fire-and-forget |
LocalEventBus, EventMap, 29 eventi |
| @mcp-suite/client-manager |
Comunicazione cross-server sincrona |
McpClientManager, callTool() |
| @mcp-suite/database |
Store SQLite base con migrazioni |
BaseStore, utility per migrazioni |
| @mcp-suite/testing |
Utility di test: harness, mock, transport |
createTestHarness(), MockEventBus |
| @mcp-suite/cli |
Utility CLI per gestione server |
Comandi per avvio, stop, status server |
Pattern Architetturali Chiave
Durante lo sviluppo di 31 server MCP sono emersi pattern architetturali ricorrenti che
garantiscono coerenza, testabilità e manutenibilità:
1. Server Factory Pattern
Ogni server espone una factory function con parametri opzionali per massima flessibilità:
export function createMyServer(options?: {
eventBus?: EventBus;
clientManager?: McpClientManager;
storeOptions?: { inMemory?: boolean; dbPath?: string };
}) {
const server = new McpServer({
name: "my-server",
version: "1.0.0",
});
const store = new MyStore(options?.storeOptions);
// Registra i tool con dipendenze opzionali
registerAddItem(server, store, options?.eventBus);
registerGetStats(server, store, options?.clientManager);
// Collaboration: attivata solo se c'è un event bus
if (options?.eventBus) {
setupCollaborationHandlers(options.eventBus, store);
}
return { server, store };
}
2. Un File per Tool
Ogni tool e isolato nel proprio file, registrato come funzione pura che riceve le dipendenze:
// tools/add-item.ts
export function registerAddItem(
server: McpServer,
store: MyStore,
eventBus?: EventBus,
): void {
server.tool(
"add-item",
"Add a new item to the store",
{ title: z.string(), content: z.string() },
async ({ title, content }) => {
try {
const item = store.addItem({ title, content });
eventBus?.publish("items:created", { id: item.id, title });
return {
content: [{ type: "text", text: JSON.stringify(item, null, 2) }],
};
} catch (error) {
return {
content: [{
type: "text",
text: `Error:
