Voxta MCP Bridge Provider

基本能力

产品定位

Voxta MCP Bridge Provider 是一个桥接服务，用于连接Voxta与MCP服务器，实现外部工具和资源的集成与通信。

核心功能

1. MCP协议通信：支持与MCP服务器的通信，实现工具和资源的调用。
2. 多语言支持：使用C#和Python进行开发，分别处理Voxta集成和MCP协议通信。
3. 自动化工具注册：自动将可用的MCP工具注册到Voxta中。
4. 配置灵活：通过appsettings.json文件进行灵活配置，支持自定义Python路径、MCP客户端脚本路径和MCP服务器地址。

适用场景

1. Voxta扩展：为Voxta提供额外的工具和资源支持。
2. MCP服务器集成：与现有的MCP服务器（如Home Assistant MCP服务器）进行集成。
3. 开发与测试：用于开发和测试MCP协议相关的功能。

工具列表

1. mcp-agent：Python库，用于处理MCP协议通信。
2. mcp_client.py：Python脚本，负责与MCP服务器的具体通信。

常见问题解答

1. MCPClientScriptPath未配置：确保appsettings.json中存在并正确配置了mcp_client.py的路径。
2. Python进程启动失败：检查Python虚拟环境是否激活，PythonExePath是否正确配置，以及mcp-agent是否安装在虚拟环境中。
3. 无法连接到MCP服务器：确认MCP服务器是否运行，MCPServerAddress配置是否正确，以及防火墙是否阻止了连接。

使用教程

使用依赖

1. .NET 8.0 SDK
2. Python 3.10或更高版本
3. Git

安装教程

Windows

1. 克隆仓库： powershell git clone https://github.com/voxta/voxta-mcp.git cd voxta-mcp
2. 创建Python虚拟环境： powershell python -m venv venv .\venv\Scripts\activate pip install mcp-agent
3. 构建并运行项目： powershell dotnet build dotnet run

Linux

1. 克隆仓库： bash git clone https://github.com/voxta/voxta-mcp.git cd voxta-mcp
2. 创建Python虚拟环境： bash python3 -m venv venv source venv/bin/activate pip install mcp-agent
3. 构建并运行项目： bash dotnet build dotnet run

调试方式

1. 确保MCP服务器运行并可访问。
2. 配置appsettings.json： json { "MCPBridge": { "PythonExePath": "venv/bin/python", "MCPClientScriptPath": "mcp_client.py", "MCPServerAddress": "localhost:50051" } }
3. 运行提供者： bash dotnet run
4. 监控控制台输出：
5. 连接状态
6. 动作触发
7. 错误信息
8. MCP工具响应

许可证

None