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

📄 許可證

[此處提供許可證信息]