Scenic MCP Experimental

🚀 Scenic MCP - 用於Scenic應用程序的輸入控制

Scenic MCP 是一個模型上下文協議 (MCP) 服務器，它能夠將外部鍵盤和鼠標輸入注入到 Scenic GUI 應用程序中。

🚀 快速開始

Scenic MCP 作為一個 MCP 服務器，為 Scenic GUI 應用程序提供了外部鍵盤和鼠標輸入注入的能力，你可以按以下步驟進行操作。

✨ 主要特性

• 鍵盤輸入：向 Scenic 應用程序發送文本和特殊按鍵。
• 鼠標控制：移動鼠標光標並在特定座標處點擊。
• MCP 集成：可與任何兼容 MCP 的客戶端（如 Claude Desktop 等）協同工作。
• 實時通信：基於 TCP 的連接，實現低延遲輸入。
• Scenic 兼容性：採用適當的 Scenic ViewPort 輸入路由。

📦 安裝指南

1. 添加到你的 Scenic 應用程序的 mix.exs 文件中：

defp deps do
  [
    {:scenic_mcp, path: "../scenic_mcp"}
  ]
end

2. 添加到你的應用程序的監管樹中： 實際上，你可能不需要這樣做...
3. 安裝 Node.js 依賴項：

cd scenic_mcp
npm install

💻 使用示例

基礎用法

MCP 工具

服務器提供了以下 MCP 工具：

• connect_scenic：測試與 Scenic 應用程序的連接。
• get_scenic_status：檢查服務器狀態和可用命令。
• send_keys：向 Scenic 應用程序發送鍵盤輸入。
  • 參數：
    • text（字符串）：要輸入的文本（每個字符作為單獨的按鍵按下發送）。
    • key（字符串）：特殊按鍵名稱（enter、escape、tab、backspace、delete、up、down、left、right、home、end、page_up、page_down、f1 - f12）。
    • modifiers（數組）：修飾鍵（ctrl、shift、alt、cmd、meta）。
• send_mouse_move：將鼠標光標移動到特定座標。
  • 參數：
    • x（數字）：X 座標。
    • y（數字）：Y 座標。
• send_mouse_click：在特定座標處點擊鼠標。
  • 參數：
    • x（數字）：X 座標。
    • y（數字）：Y 座標。
    • button（字符串）：鼠標按鈕（left、right、middle） - 默認值：left。

代碼示例

發送文本：

{
  "action": "send_keys",
  "text": "hello world"
}

發送特殊按鍵：

{
  "action": "send_keys", 
  "key": "enter"
}

發送帶修飾鍵的按鍵：

{
  "action": "send_keys",
  "key": "c",
  "modifiers": ["ctrl"]
}

移動鼠標：

{
  "action": "send_mouse_move",
  "x": 100,
  "y": 200
}

點擊鼠標：

{
  "action": "send_mouse_click",
  "x": 150,
  "y": 250,
  "button": "left"
}

🔧 技術細節

架構

MCP Client (Claude Desktop)
    ↓
TypeScript MCP Server (scenic_mcp)
    ↓ (TCP port 9999)
Elixir GenServer Bridge
    ↓ (Scenic.ViewPort.Input.send/2)
Scenic ViewPort
    ↓
Your Scenic Application

開發

啟動 Elixir 服務器：

cd your_scenic_app
mix run --no-halt

測試 MCP 服務器：

cd scenic_mcp
node src/index.ts

要求

• Elixir/OTP 24+
• Node.js 18+
• Scenic 0.11+

📄 許可證

本項目採用 MIT 許可證。