Periscope

Periscope

一个 MCP 服务，可代理到运行中且使用你实际 Neovim 配置的 Neovim 实例，让 MCP 客户端（Agent）查询与你编辑时相同的语言服务、格式化器注册表、检查器注册表和 DAP 模块树——配置只有一个可信来源，无需重复配置服务，也无需转换配置文件。

Periscope 是一个独立的 Rust 二进制程序。它通过 stdio（NDJSON JSON-RPC）与客户端通信，并通过 msgpack-RPC 与 Neovim 通信。

运行方式

• 托管模式（默认）：启动自己的 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），可在编辑器内运行配置自己的流水线。格式化会应用到代理编辑器的缓冲区，并以文本形式返回——绝不会写入磁盘文件（written 始终为 false；写入磁盘的工具将在后续阶段推出，并需通过显式启用标志开启）。Lint 仅进行读取。

四个 attention_* 工具用于由服务进程维护的联合注意力协调板（MATE 协议，vendored from phlow-attention）：Agent 可发布有序关注列表、读取彼此的关注列表，并请求对齐评分或协调决策。协调板不会触碰编辑器或文件系统；发布内容会绑定到客户端在 initialize 时提供的身份。

位置从 0 开始计数；character 按 UTF-16 代码单元计数（LSP 约定）。 LSP 请求工具会在编辑器中轮询，等待服务报告进行中的进度，因此冷启动的 rust-analyzer 会返回实际结果（小型项目约需 10 s），而不是快速返回空结果。

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',
},