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
.env
files - 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
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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 -5TypeScript
- -securityFlicense-qualityA modular, extensible Model Context Protocol server framework designed for Claude Desktop that uses convention-based automatic module discovery to easily extend AI application functionality without modifying core code.Last updated -3Python
- -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 -5PythonCreative 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 -5,128Python