MCP服务器框架

通用MCP服务器框架

一种开源的模块化MCP（模型上下文协议）服务器，旨在将大型语言模型连接到各种现实世界的应用程序。该项目提供了一个核心引擎、可插拔的服务连接器和一个用于测试的Vite+React前端。

此monorepo包含：

• /backend：Node.js MCP服务器。
• /frontend：Vite+React控制面板。

特性

• 模块化架构： 轻松添加新的服务连接器（例如Discord、Slack）。
• 默认安全： 用途 .env 文件，以保护所有机密不受版本控制。
• WhatsApp连接状态： 维护您的WhatsApp网络会话。
• 实时电报机器人： 立即连接到Telegram Bot API。
• React控制面板： 一个简单的UI来测试服务器的工具。

项目设置

先决条件

• Node.js（LTS版本，例如v20.x）
• Git

安装和配置

1. 克隆存储库：

   复制

   git clone <your-repo-url>
   cd universal-mcp-project
   

2. 设置后端：

   复制

   cd backend
   npm install
   cp .env.example .env
   

   现在，打开 backend/.env 使用文本编辑器(nano .env)并添加您的API密钥。

3. 设置前端：

   复制

   cd ../frontend
   npm install
   cp .env.example .env
   

   中的默认设置 frontend/.env 应该为当地发展而努力。

运行应用程序

为此，您需要两个单独的终端会话。

1. 启动后端服务器： 打开您的第一个终端，导航到 backend 文件夹，然后运行：

   复制

   npm run dev
   

   WhatsApp首次运行时，会出现一个二维码。用你的手机扫描一下。

2. 启动前端应用程序： 打开第二个终端，导航到 frontend 文件夹，然后运行：

   复制

   npm run dev
   

   在手机上打开网络浏览器，然后转到终端中显示的URL（通常 http://localhost:5173).

现在，您应该看到控制面板，并能够通过后端服务器执行命令。