mcpengine/README.md

290 lines
7.5 KiB
Markdown

# MCPEngine
**30 production-ready Model Context Protocol (MCP) servers for business software platforms.**
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP Version](https://img.shields.io/badge/MCP-1.0-blue.svg)](https://modelcontextprotocol.io)
**🌐 Website:** [mcpengine.com](https://mcpengine.com)
---
## 🎯 What is MCPEngine?
MCPEngine provides complete MCP server implementations for 30 major business software platforms, enabling AI assistants like Claude, ChatGPT, and others to directly interact with your business tools.
### **~240 tools across 30 platforms:**
#### 🔧 Field Service (4)
- **ServiceTitan** — Enterprise home service management
- **Jobber** — SMB home services platform
- **Housecall Pro** — Field service software
- **FieldEdge** — Trade-focused management
#### 👥 HR & Payroll (3)
- **Gusto** — Payroll and benefits platform
- **BambooHR** — HR management system
- **Rippling** — HR, IT, and finance platform
#### 📅 Scheduling (2)
- **Calendly** — Meeting scheduling
- **Acuity Scheduling** — Appointment booking
#### 🍽️ Restaurant & POS (4)
- **Toast** — Restaurant POS and management
- **TouchBistro** — iPad POS for restaurants
- **Clover** — Retail and restaurant POS
- **Lightspeed** — Omnichannel commerce
#### 📧 Email Marketing (3)
- **Mailchimp** — Email marketing platform
- **Brevo** (Sendinblue) — Marketing automation
- **Constant Contact** — Email & digital marketing
#### 💼 CRM (3)
- **Close** — Sales CRM for SMBs
- **Pipedrive** — Sales pipeline management
- **Keap** (Infusionsoft) — CRM & marketing automation
#### 📊 Project Management (4)
- **Trello** — Visual project boards
- **ClickUp** — All-in-one productivity
- **Basecamp** — Team collaboration
- **Wrike** — Enterprise project management
#### 🎧 Customer Support (3)
- **Zendesk** — Customer service platform
- **Freshdesk** — Helpdesk software
- **Help Scout** — Customer support tools
#### 🛒 E-commerce (3)
- **Squarespace** — Website and e-commerce
- **BigCommerce** — Enterprise e-commerce
- **Lightspeed** — Retail and hospitality
#### 💰 Accounting (1)
- **FreshBooks** — Small business accounting
- **Wave** — Free accounting software
---
## 🚀 Quick Start
### Install & Run a Server
```bash
# Clone the repo
git clone https://github.com/yourusername/mcpengine.git
cd mcpengine
# Choose a server
cd servers/servicetitan
# Install dependencies
npm install
# Build
npm run build
# Run
npm start
```
### Use with Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"servicetitan": {
"command": "node",
"args": ["/path/to/mcpengine/servers/servicetitan/dist/index.js"],
"env": {
"SERVICETITAN_API_KEY": "your_api_key",
"SERVICETITAN_TENANT_ID": "your_tenant_id"
}
}
}
}
```
---
## 📊 Business Research
Comprehensive market analysis included in `/research`:
- **[Competitive Landscape](research/mcp-competitive-landscape.md)** — 30 companies analyzed, 22 have ZERO MCP competition
- **[Pricing Strategy](research/mcp-pricing-research.md)** — Revenue model and pricing tiers
- **[Business Projections](research/mcp-business-projections.md)** — Financial forecasts (24-month horizon)
**Key Finding:** Most B2B SaaS verticals have no MCP coverage. Massive first-mover opportunity.
---
## 📄 Landing Pages
Marketing pages for each MCP server available in `/landing-pages`:
- 30 HTML landing pages (one per platform)
- `site-generator.js` — Bulk page generator
- `ghl-reference.html` — Design template
---
## 🏗️ Architecture
Each server follows a consistent structure:
```
servers/<platform>/
├── src/
│ └── index.ts # MCP server implementation
├── package.json # Dependencies
├── tsconfig.json # TypeScript config
└── README.md # Platform-specific docs
```
### Common Features
- ✅ Full TypeScript implementation
- ✅ Comprehensive tool coverage
- ✅ Error handling & validation
- ✅ Environment variable config
- ✅ Production-ready code
---
## 🔌 Supported Clients
These MCP servers work with any MCP-compatible client:
- **Claude Desktop** (Anthropic)
- **ChatGPT Desktop** (OpenAI)
- **Cursor** (AI-powered IDE)
- **Cline** (VS Code extension)
- **Continue** (VS Code/JetBrains)
- **Zed** (Code editor)
- Any custom MCP client
---
## 📦 Server Status
| Platform | Tools | Status | API Docs |
|----------|-------|--------|----------|
| ServiceTitan | 8 | ✅ Ready | [Link](https://developer.servicetitan.io/) |
| Mailchimp | 8 | ✅ Ready | [Link](https://mailchimp.com/developer/) |
| Calendly | 7 | ✅ Ready | [Link](https://developer.calendly.com/) |
| Zendesk | 10 | ✅ Ready | [Link](https://developer.zendesk.com/) |
| Toast | 9 | ✅ Ready | [Link](https://doc.toasttab.com/) |
| ... | ... | ... | ... |
Full status: See individual server READMEs
---
## 🛠️ Development
### Build All Servers
```bash
# Install dependencies for all servers
npm run install:all
# Build all servers
npm run build:all
# Test all servers
npm run test:all
```
### Add a New Server
1. Copy the template: `cp -r servers/template servers/your-platform`
2. Update `package.json` with platform details
3. Implement tools in `src/index.ts`
4. Add platform API credentials to `.env`
5. Build and test: `npm run build && npm start`
See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for detailed guidelines.
---
## 📚 Documentation
- **[Contributing Guide](docs/CONTRIBUTING.md)** — How to add new servers
- **[Deployment Guide](docs/DEPLOYMENT.md)** — Production deployment options
- **[API Reference](docs/API.md)** — MCP protocol specifics
- **[Security Best Practices](docs/SECURITY.md)** — Handling credentials safely
---
## 🤝 Contributing
We welcome contributions! Here's how:
1. Fork the repo
2. Create a feature branch (`git checkout -b feature/new-server`)
3. Commit your changes (`git commit -am 'Add NewPlatform MCP server'`)
4. Push to the branch (`git push origin feature/new-server`)
5. Open a Pull Request
See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.
---
## 📜 License
MIT License - see [LICENSE](LICENSE) file for details.
---
## 🌟 Why MCPEngine?
### First-Mover Advantage
22 of 30 target platforms have **zero MCP competition**. We're building the standard.
### Production-Ready
All servers are fully implemented, tested, and ready for enterprise use.
### Comprehensive Coverage
~240 tools across critical business categories. One repo, complete coverage.
### Open Source
MIT licensed. Use commercially, modify freely, contribute back.
### Business-Focused
Built for real business use cases, not toy demos. These are the tools companies actually use.
---
## 📞 Support
- **Website:** [mcpengine.com](https://mcpengine.com)
- **Issues:** [GitHub Issues](https://github.com/yourusername/mcpengine/issues)
- **Discussions:** [GitHub Discussions](https://github.com/yourusername/mcpengine/discussions)
- **Email:** support@mcpengine.com
---
## 🗺️ Roadmap
- [ ] Add 20 more servers (Q1 2026)
- [ ] Managed hosting service (Q2 2026)
- [ ] Enterprise support tiers (Q2 2026)
- [ ] Web-based configuration UI (Q3 2026)
- [ ] Multi-tenant deployment options (Q3 2026)
---
## 🙏 Acknowledgments
- [Anthropic](https://anthropic.com) — MCP protocol creators
- The MCP community — Early adopters and contributors
- All platform API documentation maintainers
---
**Built with ❤️ for the AI automation revolution.**