adya MCP hackathon

Vanij MCP平台

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

 ](https://nodejs.org/) 

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

📋 目录

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

🌟 概述

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实现

Python实现

⚙️ 配置

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团队