f3c4cd817b
=== NEW SERVERS ADDED (7) === - servers/closebot — 119 tools, 14 modules, 4,656 lines TS (Stage 7) - servers/google-console — Google Search Console MCP (Stage 7) - servers/meta-ads — Meta/Facebook Ads MCP (Stage 8) - servers/twilio — Twilio communications MCP (Stage 8) - servers/competitor-research — Competitive intel MCP (Stage 6) - servers/n8n-apps — n8n workflow MCP apps (Stage 6) - servers/reonomy — Commercial real estate MCP (Stage 1) === FACTORY INFRASTRUCTURE ADDED === - infra/factory-tools — mcp-jest, mcp-validator, mcp-add, MCP Inspector - 60 test configs, 702 auto-generated test cases - All 30 servers score 100/100 protocol compliance - infra/command-center — Pipeline state, operator playbook, dashboard config - infra/factory-reviews — Automated eval reports === DOCS ADDED === - docs/MCP-FACTORY.md — Factory overview - docs/reports/ — 5 pipeline evaluation reports - docs/research/ — Browser MCP research === RULES ESTABLISHED === - CONTRIBUTING.md — All MCP work MUST go in this repo - README.md — Full inventory of 37 servers + infra docs - .gitignore — Updated for Python venvs TOTAL: 37 MCP servers + full factory pipeline in one repo. This is now the single source of truth for all MCP work.
MCP Factory Tools
Toolchain for building, testing, validating, and shipping MCP servers at scale.
What's Installed
Testing & Validation
| Tool | Type | Purpose |
|---|---|---|
| mcp-jest (global CLI) | npm | Discover tools, generate tests, validate protocol compliance, watch mode |
| mcp-validator (Janix-ai) | Python (cloned) | Formal MCP protocol compliance reports (2024-11-05 → 2025-06-18) |
| MCP Inspector (official) | Cloned | Visual web UI for interactive server debugging |
Development
| Tool | Type | Purpose |
|---|---|---|
| FastMCP (npm) | Library | Opinionated TS framework for building new MCP servers fast |
| mcp-add (global CLI) | npm | One-liner install for customers to add servers to any MCP client |
Quick Commands
Discover all tools across 30 servers
cd factory-tools && node scripts/discover-all.mjs
Generates test configs in test-configs/ for every server.
Validate all servers for MCP compliance
cd factory-tools && node scripts/validate-all.mjs
Produces compliance reports in reports/ (JSON + Markdown).
Validate a single server
mcp-jest validate --config test-configs/calendly.json
Discover a single server's tools
mcp-jest discover --config test-configs/calendly.json
Run tests against a server (requires real API keys)
# Edit test-configs/calendly.json to add real CALENDLY_API_KEY
mcp-jest --config test-configs/calendly-tests.json
Compliance report via mcp-validator (Python)
cd mcp-validator && source .venv/bin/activate
python -m mcp_testing.scripts.compliance_report \
--server-command "node ../mcp-diagrams/mcp-servers/calendly/dist/index.js" \
--protocol-version 2025-06-18
Directory Structure
factory-tools/
├── README.md
├── package.json
├── server-registry.json # All 30 servers, their env vars
├── scripts/
│ ├── discover-all.mjs # Batch discovery
│ ├── validate-all.mjs # Batch validation
│ └── fix-unknown-tool-error.mjs # Template-level bug fix (already applied)
├── test-configs/ # Generated per-server test configs
│ ├── calendly.json # Base config (for discover/validate)
│ └── calendly-tests.json # Full test suite (for testing)
├── reports/ # Compliance & discovery reports
├── mcp-validator/ # Cloned: Python compliance testing
├── mcp-inspector/ # Cloned: Visual debugging UI
└── node_modules/ # fastmcp, mcp-jest (local)
Server Status (as of 2026-02-04)
- 30 servers, 243 tools
- 702 test cases auto-generated
- 100/100 compliance (all servers FULL compliant after bug fix)
- Bug fixed: Unknown tool error handling (McpError + ErrorCode.MethodNotFound)
For New Servers (use FastMCP)
import { FastMCP } from "fastmcp";
import { z } from "zod";
const server = new FastMCP({ name: "My Server", version: "1.0.0" });
server.addTool({
name: "my_tool",
description: "Does a thing",
parameters: z.object({ input: z.string() }),
execute: async (args) => String(result),
});
server.start({ transportType: "stdio" });
For Customer Install Docs
npx mcp-add --name calendly --type local \
--command "npx mcp-server-calendly" \
--scope global --clients "claude,cursor,vscode"