Vanij MCP 平台

🚀 MCP 集成演示视频. (观看这里)

一个全面的模型上下文协议（MCP）平台，提供AI助手与各种服务和API之间的标准化集成。此仓库包含了MCP服务器和客户端的JavaScript和Python实现，以实现无缝的服务集成。

📋 目录

• 概述
• 特性
• 项目结构
• 快速开始
• JavaScript 设置
• Python 设置
• 示例 MCP 服务器
• 配置
• 文档
• API 集合
• 贡献
• 许可证

🌟 概述

Vanij MCP 平台使AI助手能够通过标准化协议与外部服务进行交互。它提供了一个统一的接口来连接到各种API和服务，使得构建复杂的AI驱动应用程序变得更加容易。

✨ 特性

• 多语言支持：JavaScript 和 Python 实现
• 可扩展架构：易于添加新的 MCP 服务器
• 标准化协议：在所有集成中保持一致的接口
• 生产就绪：考虑了可伸缩性和可靠性
• 详尽文档：详细的指南和API参考
• 测试工具：Postman 集合用于轻松测试

📁 项目结构

.
├── mcp_servers/
│   ├── js/                           # JavaScript 实现
│   │   ├── clients/                  # MCP 客户端
│   │   │   ├── src/
│   │   │   │   ├── client_and_server_config.ts  # 列出的 MCP 客户端及服务器配置。
│   │   │   │   └── ...
│   │   │   ├── package.json   
│   │   │   └── ...
│   │   ├── servers/                  # MCP 服务器
│   │   │   ├── WORDPRESS/           # WordPress 集成
│   │   │   ├── ZOOMMCP/             # Zoom 集成
│   │   │   ├── SALESFORCE_MCP/      # Salesforce 集成
│   │   │   ├── SLACK_MCP/           # Slack 集成
│   │   │   └── etc...
│   │   └── package.json
│   └── python/                       # Python 实现
│       ├── clients/                  # MCP 客户端
│       │   ├── src/
│       │   │   ├── client_and_server_config.py       # 列出的 MCP 客户端及服务器配置。
│       │   │   └── ...
│       │   ├── requirements.txt
│       │   └── ...
│       └── servers/                  # MCP 服务器
│           ├── MCP-GSUITE/          # GSuite 集成
│           ├── FACEBOOK_MCP/        # Facebook 集成
│           ├── FACEBOOK_ADS_MCP/    # Facebook Ads 集成
│           ├── POWER_BI_MCP/        # Power BI 集成
│           └── etc ...
├── mcp_servers_documentation/        # 关于 MCP 服务器的详细文档
├── postman_api_collections/         # API 测试集合
└── README.md

🚀 快速开始

先决条件

• Node.js208+（对于 JavaScript 实现）
• Python 3.8+（对于 Python 实现）
• npm 或 yarn（对于 JavaScript 依赖项）
• pip（对于 Python 依赖项）

选择您的实现

1. JavaScript：遵循 JavaScript 设置 指南
2. Python：遵循 Python 设置 指南
3. 两者：设置两种实现以获得最大灵活性

🟨 JavaScript 设置

1. 导航至 JavaScript 目录

cd mcp_servers/js

2. 安装依赖项

npm install

3. 构建所有组件

npm run build:all

4. 启动开发服务器

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 目录

cd mcp_servers/python/clients

2. 创建虚拟环境

python -m venv venv

3. 激活虚拟环境

Windows:

venv\Scripts\activate

Unix/MacOS:

source v

4. 安装依赖项

pip install -r requirements.txt

此命令会自动安装所有服务器依赖项。

5. 运行客户端

python src/main.py

配置

Python 配置管理在：

mcp_servers/python/clients/src/client_and_server_config.py

🔌 示例 MCP 服务器

JavaScript 实现

服务器	描述	状态
WordPress	内容管理和博客操作	✅ 活跃
Zoom	视频会议和会议管理	✅ 活跃
Salesforce	CRM 和销售自动化	✅ 活跃
Slack	团队沟通和协作	✅ 活跃
Jira	项目管理和问题跟踪	✅ 活跃
Google Drive	云存储和文件管理	✅ 活跃
Zendesk	客户支持和票务	✅ 活跃
HubSpot	营销和CRM平台	✅ 活跃

Python 实现

服务器	描述	状态
GSuite	Google Workspace 集成	✅ 活跃
Facebook	社交媒体平台集成	✅ 活跃
Facebook Ads	广告和活动管理	✅ 活跃
Power BI	商业智能和分析	✅ 活跃

⚙️ 配置

JavaScript 配置

编辑 mcp_servers/js/clients/src/client_and_server_config.ts：

export const ServersConfig = [
    {
        server_name :"WORDPRESS", // 服务器名称应与 mcp_servers/js/servers/ 文件夹中的文件夹名称相同。
        server_features_and_capability:`wordpress 服务器用于从 wordpress 网站创建、更新、删除和获取内容。`,
        path : "build/index.js"
    },
    {
        server_name :"用户 MCP 服务器名称",   
        server_features_and_capability:`功能描述`,
        path : "dist/index.js" // 路径应为 mcp 服务器下的文件夹名称中的构建文件路径
    },
];

Python 配置

编辑 mcp_servers/python/clients/src/client_and_server_config.py：

ServersConfig = [
    {
		"server_name": "MCP-GSUITE",
		"command":"uv",
		"args": [
			"--directory",
			"../servers/MCP-GSUITE/mcp-gsuite",
			"run",
			"mcp-gsuite"
		]
	},
    //其他服务器...
]

📚 文档

每个 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/ 目录包含 Postman 集合，用于测试和与 MCP 服务器交互：

1. 将集合导入 Postman
2. 配置环境变量
3. 测试 API 端点
4. 验证集成

🤝 贡献

我们欢迎贡献！请遵循以下步骤：

1. 分叉 仓库
2. 创建 功能分支 (git checkout -b feature/amazing-feature)
3. 提交 您的更改 (git commit -m '添加神奇功能')
4. 推送 到分支 (git push origin feature/amazing-feature)
5. 打开 拉取请求

开发指南

• 遵循现有的代码风格和约定
• 为新功能添加测试
• 根据需要更新文档
• 提交 PR 前确保所有测试通过

📄 许可证

该项目采用 MIT 许可证 - 查看 LICENSE 文件以获取详细信息。

🆘 支持

• 文档：查看 mcp_servers_documentation/ 目录
• 问题：在 GitHub 上打开一个问题
• 讨论：使用 GitHub 讨论提问

🏗️ 发展路线图

• 额外的语言实现（Go, Rust）
• 更多第三方服务集成
• 增强监控和日志记录
• Docker 容器化
• Kubernetes 部署指南

---

由 Vanij 团队用心打造