Geniomcpserver

🚀 Genio MCP Server

Genio MCP Serverは、Haiku上のGenio IDE用のMCP（Model Context Protocol）サーバーです。Claude CodeがBMessageスクリプトAPIを通じてGenioのエディタに直接アクセスできるようにします。

✨ 主な機能

エディタの状態とナビゲーション

• get_editor_state - 現在のファイル、カーソル位置、選択範囲、変更状態、表示されている行、スクロール位置を取得
• navigate_to - 指定した行:列でファイルを開く

エディタの内容

• read_editor_buffer - 現在のエディタの内容を読み取る
• write_editor_buffer - バッファ全体を置き換える

テキスト編集

• insert_at_cursor - 選択範囲を挿入または置き換える
• append_to_file - ファイルの末尾に追加する
• undo / redo - 元に戻す/やり直す操作

🚀 クイックスタート

前提条件

# On 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をリンクします）

🔧 技術詳細

サーバーは2つのレイヤーで構成されています。

1. MCPレイヤー (src/genio_mcp_server.nim) - nimcpを使用したstdio上のJSON-RPC
2. Genioインターフェイス (src/genio_interface.nim) - 独立したHaiku API FFIバインディング

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 =
    ## Tool description
    {.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