voxta-mcp

🚀 Voxta MCP 通信桥接器提供程序

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 工具响应

✨ 主要特性

• 自动将可用的 MCP 工具注册到 Voxta。
• 当 Voxta 触发操作时，能将 Voxta 动作转换为 MCP 工具调用，通过 Python 客户端发送请求到 MCP 服务器，并接收响应返回给 Voxta。

📚 详细文档

故障排除

常见问题及解决方案：

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 消息进行通信。

📄 许可证

[此处提供许可证信息]