adya_mcp_hackathon
Vanij MCP Platform
🚀 MCP Integration Demo Video. (watch here)
A comprehensive Model Context Protocol (MCP) platform providing standardized integrations between AI assistants and various services and APIs. This repository contains both JavaScript and Python implementations of MCP servers and clients for seamless service integration.
📋 Table of Contents
- Overview
- Features
- Project Structure
- Quick Start
- JavaScript Setup
- Python Setup
- Sample MCP Servers
- Configuration
- Documentation
- API Collections
- Contributing
- License
🌟 Overview
The Vanij MCP Platform enables AI assistants to interact with external services through a standardized protocol. It provides a unified interface for connecting to various APIs and services, making it easier to build sophisticated AI-powered applications.
✨ Features
- Extensible Architecture: Easy to add new MCP servers
- Standardized Protocol: Consistent interface across all integrations
- Production Ready: Built with scalability and reliability in mind
- Comprehensive Documentation: Detailed guides and API references
- Testing Tools: Postman collections for easy testing
📁 Project Structure```
.
├── mcp_servers/
│ ├── js/ # JavaScript implementation
│ │ ├── clients/ # MCP clients
│ │ │ ├── src/
│ │ │ │ ├── client_and_server_config.ts # Listed MCP Clients & Servers Configurations.
│ │ │ │ └── ...
│ │ │ ├── package.json
│ │ │ └── ...
│ │ ├── servers/ # MCP servers
│ │ │ ├── WORDPRESS/ # WordPress integration
│ │ │ ├── ZOOMMCP/ # Zoom integration
│ │ │ ├── SALESFORCE_MCP/ # Salesforce integration
│ │ │ ├── SLACK_MCP/ # Slack integration
│ │ │ └── etc...
│ │ └── package.json
│ └── python/ # Python implementation
│ ├── clients/ # MCP clients
│ │ ├── src/
│ │ │ ├── client_and_server_config.py # Listed MCP Clients & Servers Configurations.
│ │ │ └── ...
│ │ ├── requirements.txt
│ │ └── ...
│ └── servers/ # MCP servers
│ ├── MCP-GSUITE/ # GSuite integration
│ ├── FACEBOOK_MCP/ # Facebook integration
│ ├── FACEBOOK_ADS_MCP/ # Facebook Ads integration
│ ├── POWER_BI_MCP/ # Power BI integration
│ └── etc ...
├── mcp_servers_documentation/ # Detailed documentation of about MCP servers
├── postman_api_collections/ # API testing collections
└── README.md
## 🚀 Quick Start
### Prerequisites
- **Node.js**208+ (for JavaScript implementation)
- **Python** 3.8+ (for Python implementation)
- **npm** or **yarn** (for JavaScript dependencies)
- **pip** (for Python dependencies)
### Choose Your Implementation
1. **JavaScript**: Follow the JavaScript Setup guide
2. **Python**: Follow the Python Setup guide
3. **Both**: Set up both implementations for maximum flexibility
## 🟨 JavaScript Setup
### 1. Navigate to JavaScript Directory```bash
cd mcp_servers/js
2. Install Dependencies```bash
npm install
### 3. Build All Components```bash
npm run build:all
4. Start Development Server```bash
npm run dev:client
### 5. Available Scripts
- `npm run build:all` - Build all clients and servers
- `npm run dev:client` - Run client in development mode
- `npm run test` - Run test suite
- `npm run lint` - Run linting checks
### Configuration
JavaScript configuration is managed in:```
mcp_servers/js/clients/src/client_and_server_config.ts
🐍 Python Setup
1. Navigate to Python Directory```bash
cd mcp_servers/python/clients
### 2. Create Virtual Environment```bash
python -m venv venv
3. Activate Virtual Environment
Windows:```bash
venv\Scripts\activate
**Unix/MacOS:**```bash
source venv/bin/activate
4. Install Dependencies```bash
pip install -r requirements.txt
This command automatically installs all server dependencies as well.
### 5. Run the Client```bash
python src/main.py
Configuration
Python configuration is managed in:```
mcp_servers/python/clients/src/client_and_server_config.py
## 🔌 Example MCP Servers
### JavaScript Implementation
| Server | Description | Status |
|--------|-------------|--------|
| **WordPress** | Content management and blog operations | ✅ Active |
| **Zoom** | Video conferencing and meeting management | ✅ Active |
| **Salesforce** | CRM and sales automation | ✅ Active |
| **Slack** | Team communication and collaboration | ✅ Active |
| **Jira** | Project management and issue tracking | ✅ Active |
| **Google Drive** | Cloud storage and file management | ✅ Active |
| **Zendesk** | Customer support and ticketing | ✅ Active |
| **HubSpot** | Marketing and CRM platform | ✅ Active |
### Python Implementation
| Server | Description | Status |
|--------|-------------|--------|
| **GSuite** | Google Workspace integration | ✅ Active |
| **Facebook** | Social media platform integration | ✅ Active |
| **Facebook Ads** | Advertising and campaign management | ✅ Active |
| **Power BI** | Business intelligence and analytics | ✅ Active |
## ⚙️ Configuration
### JavaScript Configuration
Edit `mcp_servers/js/clients/src/client_and_server_config.ts`:```typescript
export const ServersConfig = [
{
server_name :"WORDPRESS", // Server Name should be same as the folder name in mcp_servers/js/servers/ folder.
server_features_and_capability:`wordpress server is used to create, update, delete and get content from wordpress website.`,
path : "build/index.js"
},
{
server_name :"User MCP Server Name",
server_features_and_capability:`feactures description`,
path : "dist/index.js" // path should be the build file path in the mcp Server under the folder name
},
];
Python Configuration
Edit mcp_servers/python/clients/src/client_and_server_config.py:python
ServersConfig = [
{
"server_name": "MCP-GSUITE",
"command":"uv",
"args": [
"--directory",
"../servers/MCP-GSUITE/mcp-gsuite",
"run",
"mcp-gsuite"
]
},
//other servers...
]
📚 Documentation
Comprehensive documentation for each MCP server is available in the mcp_servers_documentation/ directory:
- Server-specific setup guides
- API reference documentation
- Integration examples
- Troubleshooting guides
Key Documentation Files
mcp_servers_documentation/server_setup.md- General server setupmcp_servers_documentation/api_reference.md- API documentationmcp_servers_documentation/examples/- Integration examples
🧪 API Collections
The postman_api_collections/ directory contains Postman collections for testing and interacting with MCP servers:
- Import collections into Postman
- Configure environment variables
- Test API endpoints
- Validate integrations
🤝 Contributing
We welcome contributions! Please follow these steps:
- 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
Development Guidelines
- Follow existing code style and conventions
- Add tests for new features
- Update documentation as needed
- Ensure all tests pass before submitting PR
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Support
- Documentation: Check the
mcp_servers_documentation/directory - Issues: Open an issue on GitHub
- Discussions: Use GitHub Discussions for questions
🏗️ Roadmap
- [ ] Additional language implementations (Go, Rust)
- [ ] More third-party service integrations
- [ ] Enhanced monitoring and logging
- [ ] Docker containerization
- [ ] Kubernetes deployment guides
Built with ❤️ by the Vanij Team
