Vanij MCP平台
🚀 MCP集成演示视频。(看这里)
一个全面的模型上下文协议(MCP)平台,提供AI助手和各种服务和API之间的标准化集成。此存储库包含MCP服务器和客户端的JavaScript和Python实现,以实现无缝的服务集成。
📋 目录
- 概述
- 特性
- 项目结构
- 快速开始
- JavaScript设置
- Python设置
- MCP服务器示例
- 配置
- 文档
- API集合
- 贡献
- 许可证
🌟 概述
Vanij MCP平台使AI助手能够通过标准化协议与外部服务进行交互。它提供了一个统一的接口,用于连接各种API和服务,使构建复杂的人工智能应用程序变得更加容易。
✨ 特性
- 可扩展架构:易于添加新的MCP服务器
- 标准化协议:跨所有集成的一致界面
- 生产就绪:考虑到可扩展性和可靠性
- 综合文档:详细指南和API参考资料
- 测试工具:邮差系列,便于测试
📁 项目结构```
.
├── 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
## 🚀 快速开始
### 先决条件
- **Node.js**208+(用于JavaScript实现)
- **python** 3.8+(用于Python实现)
- **npm** 或 **纱线** (用于JavaScript依赖关系)
- **点** (适用于Python依赖项)
### 选择您的实施方案
1. **脚本**:遵循 JavaScript设置 指南
1. **python**:遵循 Python设置 指南
1. **两者**:设置两种实现以获得最大的灵活性
## 🟨 JavaScript设置
### 1.导航到JavaScript目录```bash
cd mcp_servers/js
2.安装依赖项```bash
npm install
### 3.构建所有组件```bash
npm run build:all
4.启动开发服务器```bash
npm run dev:client
### 5.可用脚本
- `npm run build:all` -构建所有客户端和服务器
- `npm run dev:client` -在开发模式下运行客户端
- `npm run test` -运行测试套件
- `npm run lint` -运行衣冠检查
### 配置
JavaScript配置在以下位置管理:```
mcp_servers/js/clients/src/client_and_server_config.ts
🐍 Python设置
1.导航到Python目录```bash
cd mcp_servers/python/clients
### 2.创建虚拟环境```bash
python -m venv venv
3.激活虚拟环境
窗户:```bash
venv\Scripts\activate
**Unix/MacOS:**```bash
source venv/bin/activate
4.安装依赖项```bash
pip install -r requirements.txt
此命令还会自动安装所有服务器依赖项。
### 5.运行客户端```bash
python src/main.py
配置
Python配置在以下位置管理:```
mcp_servers/python/clients/src/client_and_server_config.py
## 🔌 MCP服务器示例
### JavaScript实现
服务器 · 描述 · 状态
**WordPress** · 内容管理和博客运营 · ✅ 活动
**变焦** · 视频会议和会议管理 · ✅ 活动
**Salesforce公司** · CRM和销售自动化✅ 活动
**Slack** · 团队沟通与协作 · ✅ 活动
**Jira** · 项目管理和问题跟踪 · ✅ 活动
**Google 云端硬盘** · 云存储和文件管理 · ✅ 活动
**反馈系统** · 客户支持和票务 · ✅ 活动
**HubSpot** · 营销和CRM平台 · ✅ 活动
### Python实现
|服务器|描述|状态|
|--------|-------------|--------|
| **GSuite** |谷歌工作区集成|✅ 活动|
| **脸书** |社交媒体平台整合|✅ 活动|
| **Facebook广告** |广告和活动管理|✅ 活动|
| **Power BI** |商业智能和分析|✅ 活动|
## ⚙️ 配置
### JavaScript配置
编辑 `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配置
编辑 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...
]
📚 文档
每个MCP服务器的综合文档可在 mcp_servers_documentation/ 目录:
- 特定于服务器的设置指南
- API参考文件
- 集成示例
- 故障排除指南
关键文档文件
mcp_servers_documentation/server_setup.md-常规服务器设置mcp_servers_documentation/api_reference.md-API文件mcp_servers_documentation/examples/-集成示例
🧪 API集合
这 postman_api_collections/ 目录包含用于测试和与MCP服务器交互的Postman集合:
- 将藏品导入Postman
- 配置环境变量
- 测试API端点
- 验证集成
🤝 贡献
我们欢迎捐款!请按照以下步骤操作:
- 分叉 存储库
- 创建 特征分支(
git checkout -b feature/amazing-feature) - 提交 您的更改(
git commit -m 'Add amazing feature') - 推 到分行(
git push origin feature/amazing-feature) - 打开 拉取请求
开发指南
- 遵循现有的代码风格和约定
- 为新功能添加测试
- 根据需要更新文档
- 在提交PR之前,确保所有测试都通过
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🆘 支持
- 文档:检查
mcp_servers_documentation/目录 - 问题:在GitHub上打开一个问题
- 讨论:使用GitHub讨论提问
🏗️ Roadmap
- []其他语言实现(Go、Rust)
- []更多第三方服务集成
- []加强监测和记录
- []Docker容器化
- []Kubernetes部署指南
内置于❤️ Vanij团队
