mcps

First-party MCPs maintained by the decocms team.

Getting Started

After cloning the repository, install dependencies:

bun install

This will automatically set up git hooks that run formatting and linting checks before each commit.

To manually set up the git hooks later, run:

bun run prepare

Creating a New MCP

Use the new.ts script to quickly scaffold a new MCP app from templates:

bun run new <name> [options]

Options

• -t, --template <type> - Template type: minimal or with-view (default: with-view)
• --no-view - Remove view/frontend code (API only)
• -d, --description - Description for package.json
• -h, --help - Show help message

Examples

Create an MCP with a React view:

bun run new weather-mcp

Create an API-only MCP (no view):

bun run new weather-api --no-view

Create from minimal template:

bun run new my-mcp --template minimal

Create with custom description:

bun run new weather-api --no-view --description "Weather forecast API"

Templates

• with-view - Full-featured MCP with a Vite + React view

  • Includes Tailwind CSS, React Router, React Query
  • Cloudflare Workers backend
  • Perfect for MCPs that need a UI

• minimal - Lightweight API-only MCP

  • Just the server code, no frontend
  • Smaller dependency footprint
  • Perfect for pure API/tool MCPs

The minimal template is automatically created from template-with-view when first needed.

After Creating

cd your-mcp-name
bun install
bun run dev

That's it! The deployment workflows will automatically detect your new MCP - no manual configuration needed.

Deployment

This monorepo uses centralized GitHub Actions workflows with automatic MCP discovery.

How It Works

• 🔍 Automatic MCP Discovery: The workflows automatically find all directories with a package.json (excluding special folders like scripts, shared, etc.)
• 🎯 Smart Change Detection: Uses git diff to detect which MCPs have changed in each commit or PR
• 🚀 Selective Deployment: Only MCPs with actual changes are built and deployed
• ⚡ Parallel Execution: Multiple changed MCPs deploy simultaneously using GitHub's matrix strategy

Workflows

• .github/workflows/deploy.yml - Production deployment on push to main
• .github/workflows/deploy-preview.yml - Preview deployment on pull requests

What Gets Deployed?

Production (push to main):

• Compares current commit with previous commit
• Deploys all MCPs that have file changes

Preview (pull requests):

• Compares PR branch with base branch (main)
• Deploys all MCPs that have changes in the PR
• Posts preview URLs as a comment on the PR

Manual Deployment

You can also deploy MCPs manually using the deployment script:

# Deploy to production
bun run scripts/deploy.ts your-mcp-name

# Deploy preview
bun run scripts/deploy.ts your-mcp-name --preview

Requirements

Each MCP directory must have:

• A package.json with a build script
• Build output in dist/server directory (or as configured for Deco)

Repository requirements:

• DECO_DEPLOY_TOKEN secret configured in GitHub repository settings

Adding a New MCP

Just create a new directory with a package.json - that's it! The workflows will automatically:

1. Detect it as an MCP
2. Monitor it for changes
3. Deploy it when changes are pushed

No manual workflow configuration needed!