Voxta MCP 通信桥接器提供程序

一个使 Voxta 能够与 Model Context Protocol (MCP) 服务器通信的提供商，允许 Voxta 利用外部工具和资源通过 MCP 协议。

先决条件

• .NET 8.0 SDK
• Python 3.10 或更高版本
• Git

设置说明

Windows

1. 克隆仓库：

   git clone https://github.com/voxta/voxta-mcp.git
   cd voxta-mcp
   

2. 创建 Python 虚拟环境：

   python -m venv venv
   .\venv\Scripts\activate
   pip install mcp-agent
   

3. 构建并运行项目：

   dotnet build
   dotnet run
   

Linux

1. 克隆仓库：

   git clone https://github.com/voxta/voxta-mcp.git
   cd voxta-mcp
   

2. 创建 Python 虚拟环境：

   python3 -m venv venv
   source venv/bin/activate
   pip install mcp-agent
   

3. 构建并运行项目：

   dotnet build
   dotnet run
   

运行提供程序

1. 确保您的 MCP 服务器正在运行且可以配置为指定地址。

2. 配置 appsettings.json 设置：

   {
     "MCPBridge": {
       "PythonExePath": "venv/bin/python",  // 虚拟环境中的 Python 可执行文件路径
       "MCPClientScriptPath": "mcp_client.py",  // MCP 客户端脚本的路径
       "MCPServerAddress": "localhost:50051"  // 您的 MCP 服务器地址
     }
   }
   

3. 运行提供程序：

   dotnet run
   

4. 提供程序将执行以下操作：

   • 启动 Python MCP 客户端进程
   • 连接到您的 MCP 服务器
   • 在 Voxta 中注册
   • 开始处理动作请求

5. 监控控制台输出以获取：

   • 连接状态
   • 动作触发
   • 错误消息
   • MCP 工具响应

故障排除

常见问题及解决方案：

1. "MCPClientScriptPath 未配置"

   • 确保 appsettings.json 存在且具有正确的 mcp_client.py 路径

2. Python 进程无法启动

   • 验证虚拟环境是否已激活
   • 检查 PythonExePath 配置
   • 确保 mcp-agent 已安装在虚拟环境中

3. 无法连接到 MCP 服务器

   • 验证服务器是否运行
   • 检查 MCPServerAddress 配置
   • 确保没有防火墙阻止连接

配置

提供程序通过 appsettings.json 进行配置：

{
  "MCPBridge": {
    "PythonExePath": "venv/bin/python",  // Linux 上： "venv/bin/python"
    "MCPClientScriptPath": "mcp_client.py",  // 必填：指向 Python MCP 客户端脚本的路径
    "MCPServerAddress": "localhost:50051"  // 您的 MCP 服务器地址
  }
}

使用说明

1. 提供程序将自动注册可用的 MCP 工具到 Voxta。

2. 当 Voxta 触发操作时，提供程序会：

   • 将 Voxta 动作转换为 MCP 工具调用
   • 通过 Python 客户端发送请求到 MCP 服务器
   • 接收响应并将其返回给 Voxta

开发

• C# 代码处理 Voxta 集成和进程管理
• Python 脚本 (mcp_client.py) 处理 MCP 协议通信
• 两个组件通过标准输入/输出使用 JSON 消息进行通信

许可证

[此处提供许可证信息]