Geniomcpserver

🚀 Genio MCP 服務器

Genio MCP 服務器是專為 Haiku 系統上的 Genio IDE 設計的 Model Context Protocol（MCP）服務器。它藉助 BMessage 腳本 API，讓 Claude Code 能夠直接訪問 Genio 編輯器，為開發者提供了便捷高效的開發體驗。

✨ 主要特性

編輯器狀態與導航

• get_editor_state：獲取當前文件、光標位置、選中內容、修改狀態、可見行以及滾動位置等信息。
• navigate_to：在指定的行和列位置打開文件。

編輯器內容操作

• read_editor_buffer：讀取當前編輯器的內容。
• write_editor_buffer：替換整個編輯器緩衝區的內容。

文本編輯功能

• insert_at_cursor：在光標位置插入或替換選中內容。
• append_to_file：在文件末尾追加內容。
• undo / redo：撤銷或重做操作。

🚀 快速開始

前提條件

# 在 Haiku 系統上
pkgman install nim          # 需要 Nim >= 2.0.0

構建與安裝

# 構建服務器（自動安裝依賴項）
nimble build

# 運行測試（需要 Genio 正在運行）
nimble test

# 添加到 Claude Code
claude mcp add --transport stdio genio -- $PWD/genio_mcp_server

或者手動在 ~/.config/claude-code/config.json 中進行配置：

{
  "mcpServers": {
    "genio": {
      "command": "/path/to/genio_mcp_server",
      "transport": "stdio"
    }
  }
}

配置說明

構建設置位於以下文件中：

• genio_mcp_server.nimble：包含包元數據、依賴項以及後端選擇等信息。
• nim.cfg：編譯器標誌（需要使用 C++ 後端，並鏈接 -lbe）。

🔧 技術細節

服務器分為兩層：

1. MCP 層（src/genio_mcp_server.nim）：使用 nimcp 通過標準輸入輸出實現 JSON-RPC。
2. Genio 接口層（src/genio_interface.nim）：獨立的 Haiku API 外部函數接口綁定。

與 Genio 的通信使用 Haiku 的 BMessage 協議，示例代碼如下：

var msg = newBMessage(MSG_GET_PROPERTY)
msg.addSpecifier("CaretPosition")
msg.addSpecifier("SelectedEditor")
let reply = genio.sendMessage(msg)

💻 使用示例

基礎用法

在 src/genio_mcp_server.nim 中添加工具的示例代碼：

mcpTool:
  proc my_tool(arg: string): string =
    ## 工具描述
    {.cast(gcsafe).}:
      let result = genio.someOperation(arg)
      if result.isSome: return result.get()
      else: raise newException(IOError, "Failed")

測試

nimble test

共有 18 個測試用例，涵蓋了連接、導航、編輯器狀態、文本操作以及撤銷/重做等功能。

📚 詳細文檔

故障排除

服務器無法連接

• 確保 Genio 正在運行。
• 運行 ./genio_mcp_server，應該看到 "Connected to Genio IDE" 信息。

構建錯誤

• nimcp not found：運行 nimble install nimcp。
• BApplication undefined：安裝 Haiku 開發頭文件：pkgman install haiku_devel。

📄 許可證

本項目採用 MIT 許可證。