AI导哈

AI助手服务集成平台

Vanij MCP平台是一个标准化的AI助手与各种服务和API集成的协议平台，提供JavaScript和Python实现，支持多种第三方服务集成。

  • by Ashwand5
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ashwand5/adya_mcp_hackathon

使用说明

adya_mcp_hackathon

Vanij MCP平台

🚀 MCP集成演示视频。（看这里）

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

📋 目录

🌟 概述

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

✨ 特性

  • 多语言支持：JavaScript和Python实现
  • 可扩展架构：易于添加新的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.js208+（用于JavaScript实现）
  • python 3.8+（用于Python实现）
  • npm 或 纱线 （用于JavaScript依赖关系）
  • 点 （适用于Python依赖项）

选择您的实施方案

  1. 脚本：遵循 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.激活虚拟环境

窗户：

venv\Scripts\activate

Unix/MacOS：

source venv/bin/activate

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 内容管理和博客运营 ✅ 活动
变焦 视频会议和会议管理 ✅ 活动
Salesforce公司 CRM和销售自动化✅ 活动
Slack 团队沟通与协作 ✅ 活动
Jira 项目管理和问题跟踪 ✅ 活动
Google 云端硬盘 云存储和文件管理 ✅ 活动
反馈系统 客户支持和票务 ✅ 活动
HubSpot 营销和CRM平台 ✅ 活动

Python实现

服务器 描述 状态
GSuite 谷歌工作区集成 ✅ 活动
脸书 社交媒体平台整合 ✅ 活动
Facebook广告 广告和活动管理 ✅ 活动
Power BI 商业智能和分析 ✅ 活动

⚙️ 配置

JavaScript配置

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

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:

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集合：

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

🤝 贡献

我们欢迎捐款！请按照以下步骤操作：

  1. 分叉 存储库
  2. 创建 特征分支(git checkout -b feature/amazing-feature)
  3. 提交 您的更改(git commit -m 'Add amazing feature')
  4. 推 到分行(git push origin feature/amazing-feature)
  5. 打开 拉取请求

开发指南

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

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🆘 支持

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

🏗️ Roadmap

  • []其他语言实现（Go、Rust）
  • []更多第三方服务集成
  • []加强监测和记录
  • []Docker容器化
  • []Kubernetes部署指南

内置于❤️ Vanij团队

相关 MCP