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 分

    請在儲存庫或註冊中心條目中宣告授權條款。