Periscope

Periscope

実際に稼働している Neovim と、実際にお使いの diver 設定を仲介する MCP サーバーです。MCP クライアント（エージェント）は、編集時と同じ言語サーバー、フォーマッターレジストリ、リンターレジストリ、DAP モジュールツリーを参照できます。設定の信頼できる唯一の情報源を共有し、サーバーの重複や設定ファイルの変換は不要です。

Periscope は単一の Rust バイナリです。クライアントとは stdio（NDJSON JSON-RPC）、Neovim とは msgpack-RPC で通信します。

動作方法

• 管理モード（デフォルト）：独自の nvim --headless --listen <tmp socket> を起動し、cwd を ワークスペースに設定します。設定は、お使いの環境とまったく同じように読み込まれます。ブローカーが対話中のエディターに触れることはありません。プロジェクトローカルの設定の実行は拒否されます（--cmd "set noexrc"）。
• 接続モード（--attach <socket>）：すでに起動している Neovim（--listen 付きで起動したもの）に接続します。ブローカーが、自身で起動していないエディターにシグナルを送ったり、終了させたりすることはありません。

ツールは、nvim_exec_lua を介してエディター内で実行される小さな Lua プログラムです。ネイティブ API（vim.lsp、vim.diagnostic、ランタイムファイル）のみを使用し、lsp/*.lua ファイルにあるサーバーごとの設定をすべて引き継ぎます。これには、rust-analyzer のネイティブ診断を無効にし、代わりに bacon-ls を使うといった意図的な選択も含まれます。

ツール

読み取り専用のインテリジェンスツール（broker_status、get_*、list_*）に加えて、設定独自のパイプラインをエディター内で実行する実行ツール（run_format、run_lint）が 2 つあります。フォーマットはブローカー経由のエディターバッファに適用され、テキストとして返されます。ディスク上のファイルは書き込まれません（written は常に false です。ディスクへの書き込みツールは、明示的な有効化フラグのもとで後続フェーズに追加される予定です）。リンティングは読み取りのみです。4 つの attention_* ツールは、サーバープロセス内に保持される共同注意の調整ボード（phlow-attention からベンダー提供された MATE プロトコル）を利用します。エージェントは順序付きのフォーカスを公開し、互いのフォーカスを読み取り、整合性スコアや調整の判断を求められます。このボードがエディターやファイルシステムに触れることはありません。また、公開操作は initialize 時にクライアントが提示した ID に紐づけられます。

位置は 0 始まりです。character は UTF-16 コード単位で数えます（LSP の規約）。 LSP リクエスト用ツールは、サーバーが処理中の進捗を報告する間、エディター内でポーリングします。そのため、起動直後の rust-analyzer でも、すばやく空の結果を返すのではなく、実際の回答が返されます（小規模なプロジェクトで約 10 秒）。

periscope [--workspace <dir>] [--attach <socket>] [--nvim-bin <path>]

periscope = {
    args = { '--workspace', '/path/to/project' },
    cmd = '/home/phaedrus/.local/bin/periscope',
    kind = 'stdio',
    name = 'periscope',
    source = 'local',
    timeout = 5000,
    tools = 'all',
},