Periscope

ai.qompass由 qompass.ai 发布v1.0.0更新于 Nov 3, 2026

MCP broker into your live Neovim/diver config: LSP, formatters, linters, DAP, MATE attention.

已验证STDIO仅桌面

概览

Periscope 的本地 MCP 服务，由 qompass.ai 发布；无需登录；STDIO。

暂无 AI 概览：以下信息来自注册中心条目和服务本身。

发布者
qompass.ai

安装

在 SourceWeft 中

  1. 打开 控制台中的 Periscope，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Periscope

An MCP server that brokers to a real Neovim running your actual diver config, so MCP clients (agents) query the same language servers, formatter registry, linter registry, and DAP module tree you edit with — one configuration source of truth, no duplicate servers, no translated config files.

Periscope is a single Rust binary. It speaks MCP over stdio (NDJSON JSON-RPC) to the client and msgpack-RPC to Neovim.

How it runs

  • Managed mode (default): spawns its own nvim --headless --listen <tmp socket> with cwd set to the workspace. Your config loads exactly as it does for you; the broker never touches your interactive editor. Project-local config execution is refused (--cmd "set noexrc").
  • Attach mode (--attach <socket>): connects to a Neovim you already have running (anything started with --listen). The broker never signals or closes an editor it did not spawn.

Tools are small Lua programs executed inside the editor via nvim_exec_lua. They use native APIs only (vim.lsp, vim.diagnostic, runtime files) and inherit every per-server setting in your lsp/*.lua files — including deliberate choices like rust-analyzer's native diagnostics being disabled in favour of bacon-ls.

Tools

Read-only intelligence (broker_status, get_*, list_*) plus two execution tools (run_format, run_lint) that run the config's own pipelines inside the editor. Formatting is applied to the brokered editor's buffer and returned as text — the file on disk is never written (written is always false; write-to-disk tools are a later phase behind an explicit enable flag). Linting only reads. Four attention_* tools serve a joint-attention coordination board held in the server process (the MATE protocol, vendored from phlow-attention): agents publish an ordered focus, read each other's, and ask for an alignment score or a coordination decision. The board never touches the editor or the filesystem, and a publish is bound to the identity the client presented at initialize.

ToolWhat it returns
attention_alignmentAlignment between your published focus and a partner agent's, measured only inside one saliency snapshot frame (Jaccard overlap, shared targets, shared top); refused across frames
attention_decideCoordination decision against a partner agent's focus: parallel (no contention), serialize (same top target — the named holder proceeds, you defer), or reject (stale frame or invalid focus — re-snapshot, never guess)
attention_focusA partner agent's currently advertised focus (ordered salient targets + the snapshot hash it was computed from) from the coordination board
attention_publishPublish your focus to the coordination board: a focus document {agent_id, snapshot_hash, seq, targets[]} (at most 8 targets); the agent_id must equal your client identity and sequences must strictly advance
broker_statusmode, Neovim version, cwd, config root
get_definitionmerged definition locations across attached clients
get_diagnosticsbuffer diagnostics from vim.diagnostic (LSP + linter pipelines), with the producing source named on every entry
get_document_symbolsflattened symbol outline with containers
get_hoverhover text at a position
get_referencesmerged reference locations across attached clients
list_dapDAP modules in the config tree plus adapters/configurations registered in the session
list_formattersformatter modules in the config tree
list_linterslinter modules in the config tree (underscore-prefixed modules reported as internal)
list_serversLSP servers configured in the tree, plus servers attached to any open buffer
run_formatFormat a file with the config's formatter pipeline (require('formatters')); optional explicit formatter names and LSP mode (fallback / never / only); returns status, changed, the steps that ran, and the formatted text
run_lintLint a file with the config's linter runner (require('linters')); optional explicit linter names, otherwise the filetype's configured set; returns per-linter status, exit code, and diagnostics (each naming its linter in source)

Positions are 0-based; character counts UTF-16 code units (the LSP convention). LSP request tools poll inside the editor while servers report in-flight progress, so a cold rust-analyzer returns its real answer (~10 s on a small project) instead of a fast, empty one.

Usage 
periscope [--workspace <dir>] [--attach <socket>] [--nvim-bin <path>]
  • --workspace defaults to the current directory and is where the managed editor starts.
  • Register it where you register MCP servers; in diver that is a declared_servers entry in lua/ai/mcp/declared_servers.lua:
lua
periscope = {    args = { '--workspace', '/path/to/project' },    cmd = '/home/phaedrus/.local/bin/periscope',    kind = 'stdio',    name = 'periscope',    source = 'local',    timeout = 5000,    tools = 'all',},

Adapt cmd/args to the installation; drop the --workspace arg entry to use the client's working directory, or point it at a running editor with --attach <socket> instead.

Budgets and bounds

Every wait and every list is bounded: editor attach 20 s, LSP request phase 30 s (progress-gated polling), diagnostics settle 5 s, connect deadline 10 s, VimEnter readiness 20 s. Result caps: 500 diagnostics locations per call, 1,000 document symbols (depth 6), 500 definition/reference locations, 4 MiB per MCP input line. Errors from the editor are forwarded capped at 512 characters. Tool failures are in-band MCP isError results, never protocol errors.

Security posture

stdio transport only — nothing listens on a network port. The managed editor's socket lives in a private temp path and is removed on shutdown; the broker reaps its child. No tool writes a file to disk, renames, or starts a debug session: formatting changes only the brokered editor's buffer and is returned as text, and the attention board is in-process memory that is dropped when the server exits.

Roadmap
  • P2 (done): formatter and linter execution through the config's own pipelines (run_format, run_lint).
  • P3: write tools (rename, code actions, format-and-write) behind an explicit enable flag.
  • P4: SCIP query tools over index.scip (native Rust reader).
  • P5: DAP session driving.

来源：README.md，提交 0d9ac9a

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：该软件包类型无法在沙箱中运行。

版本历史

2
  1. v1.0.0最新Nov 3, 2026
  2. v0.1.0Oct 21, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。