AI Development Pipeline MCP Integration
A comprehensive Model Context Protocol (MCP) server implementation that enables seamless integration between Claude AI, VSCode, Augment, and various cloud services including Vercel, Airtable, and Square.
🚀 Features
Local MCP Server: Direct stdio integration with Claude Desktop
Cloud MCP Server: HTTP endpoint for web-based Claude integration
7 Powerful MCP Tools: File operations, shell commands, and AI agent integration
Multi-Platform Support: Windows (PowerShell) and Unix (Bash) startup scripts
Production Ready: Vercel deployment configuration included
📋 Prerequisites
Node.js 18+ and npm
TypeScript and ts-node
Claude Desktop (for local integration)
Vercel account (for cloud deployment)
🛠️ Installation
Clone the repository:
Install dependencies:
Configure environment variables:
🔧 Configuration
Create a .env
file in the root directory with the following variables:
🖥️ Local MCP Server Setup
For Windows (PowerShell):
For Unix/Linux/macOS (Bash):
Manual Start:
🔗 Claude Desktop Integration
Start the local MCP server using one of the methods above
Configure Claude Desktop by adding the following to your Claude Desktop configuration:
Restart Claude Desktop to load the MCP server
☁️ Cloud Deployment (Vercel)
Automatic Deployment (Recommended)
Connect to GitHub:
Go to Vercel Dashboard
Click "New Project" and import your GitHub repository
Vercel will automatically detect the configuration
Manual Deployment:
Build Configuration
The project includes a vercel.json
configuration that handles:
TypeScript compilation
API route setup
CORS headers
Output directory configuration
Environment Variables
Configure these in your Vercel dashboard:
AIRTABLE_API_KEY
AIRTABLE_BASE_ID
AIRTABLE_TABLE_NAME
SQUARE_ACCESS_TOKEN
SQUARE_APPLICATION_ID
NEXTAUTH_SECRET
MCP_API_KEY
All other variables from
.env.example
Claude Integration
Add to Claude as an HTTP MCP server:
URL:
https://your-app.vercel.app/api/mcp
Method: POST
Headers:
Content-Type: application/json
🛠️ Available MCP Tools
The server provides 7 powerful tools for AI-driven development:
read_project_file
- Read files from the workspacewrite_project_file
- Write/update files in the workspacerun_shell_command
- Execute shell commands (npm, git, etc.)check_file_exists
- Check if files existlist_directory_files
- List directory contentsrun_augment_prompt
- Send prompts to Augment coding agentrun_project_tests
- Execute project tests
📁 Project Structure
🧪 Testing
Run the TypeScript compiler to check for errors:
Test the local MCP server:
🔒 Security Considerations
Never commit - They contain sensitive API keys
Use environment variables for all secrets in production
Review API permissions before deploying to production
Enable proper authentication for cloud deployments
🤝 Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature
)Commit your changes (
git commit -m 'Add amazing feature'
)Push to the branch (
git push origin feature/amazing-feature
)Open a Pull Request
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Troubleshooting
Common Issues:
"Module not found" errors:
Ensure all dependencies are installed:
npm install
Check TypeScript configuration in
tsconfig.json
MCP server won't start:
Verify Node.js version (18+ required)
Check that ts-node is available:
npx ts-node --version
Claude Desktop integration issues:
Ensure the MCP server is running before starting Claude
Check the file path in Claude Desktop configuration
Restart Claude Desktop after configuration changes
Getting Help:
Check the Issues page
Review the MCP documentation at modelcontextprotocol.io
Join the Claude AI community discussions
🔗 Related Projects
📊 Project Status
✅ Ready for Production
Local MCP server fully functional
Cloud deployment configured
All 7 MCP tools tested and validated
Cross-platform startup scripts included
Comprehensive documentation provided
Built with ❤️ for the AI development community
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A Model Context Protocol server that enables seamless integration between Claude AI and development tools like VSCode, Augment, Vercel, Airtable, and Square.
Related MCP Servers
- -securityFlicense-qualityA comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.Last updated -5
- -securityAlicense-qualityA Model Context Protocol server that connects Claude AI to QGIS, enabling direct interaction with the GIS software for project creation, layer manipulation, code execution, and processing algorithms through natural language prompts.Last updated -6Creative Commons Zero v1.0 Universal
- -securityFlicense-qualityA Model Context Protocol server that gives Claude access to multiple AI models (Gemini, OpenAI, OpenRouter) for enhanced code analysis, problem-solving, and collaborative development through AI orchestration with conversations that continue across tasks.Last updated -7,222