Skip to content
/ Tech-MCP Public

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

www.federicocalo.dev
2 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

fedcal/Tech-MCP

BranchesTags

Repository files navigation

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 / License

MIT

Contribuire / Contributing

I contributi sono benvenuti! Vedi docs/it/15-sviluppi-futuri/ per la roadmap e le aree dove serve aiuto.

Contributions are welcome! See docs/en/15-future-developments/ for the roadmap and areas where help is needed.

  1. Fai fork del repository / Fork the repository
  2. Crea un branch / Create a branch (git checkout -b feature/new-feature)
  3. Committa le modifiche / Commit your changes (git commit -m 'Add new feature')
  4. Pusha il branch / Push the branch (git push origin feature/new-feature)
  5. Apri una Pull Request / Open a Pull Request

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

About

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

www.federicocalo.dev

Topics

mcp mcp-server mcp-client

Resources

Readme
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages