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
Related MCP server: MCP-BOS
π 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_KEYAIRTABLE_BASE_IDAIRTABLE_TABLE_NAMESQUARE_ACCESS_TOKENSQUARE_APPLICATION_IDNEXTAUTH_SECRETMCP_API_KEYAll other variables from
.env.example
Claude Integration
Add to Claude as an HTTP MCP server:
URL:
https://your-app.vercel.app/api/mcpMethod: 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 installCheck 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