Skip to content
MCP server

Periscope

Rust MCP broker into a live Neovim config for LSP, formatters, linters and DAP

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Linux, CLI, self-hosted
Runs
Locally
Version
1.0.0
Listing updated
3 days ago

About Periscope

Periscope is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Periscope lets an agent use the same language servers, formatter registry, linter registry and DAP module tree that you edit with, instead of running duplicate servers or translated config files. It is a single Rust binary that speaks MCP over stdio to the client and msgpack-RPC to Neovim.

In the default managed mode it spawns its own headless Neovim in the workspace, so your config loads as normal and your interactive editor is untouched; project-local config execution is refused. Attach mode connects to a Neovim you already started with --listen. The tools are small Lua programs run inside the editor using native APIs, so per-server LSP settings carry over.

Most tools are read-only (definitions, references, hover, diagnostics, symbols and config listings). run_format and run_lint execute the config's own pipelines; formatting returns text for the buffer and never writes to disk. Four attention tools host a MATE joint-attention board where agents publish and compare focus.

Install

Run in a terminal

claude mcp add periscope -- npx -y https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "periscope": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

broker_status
Mode, Neovim version, cwd and config root.
get_definition
Merged definition locations across attached clients.
get_diagnostics
Buffer diagnostics from LSP and linter pipelines.
get_document_symbols
Flattened symbol outline with containers.
get_hover
Hover text at a position.
get_references
Merged reference locations across attached clients.
list_dap
DAP modules in the config tree and registered adapters.
list_formatters
Formatter modules in the config tree.
list_linters
Linter modules in the config tree.
list_servers
LSP servers configured or attached to open buffers.
run_format
Format a file with the config's formatter pipeline.
attention_publish
Publish your focus to the coordination board.
attention_focus
Read a partner agent's advertised focus.
attention_alignment
Measure alignment between two agents' focus.
attention_decide
Return a parallel, serialize or reject coordination decision.

What it does

Real Neovim config
Queries the language servers and registries from your actual setup.
Managed or attach mode
Spawns a headless Neovim or connects to one you already run.
Code intelligence
Definitions, references, hover, diagnostics and document symbols.
Format and lint pipelines
Runs your formatters and linters without writing files to disk.
DAP and registry listing
Lists debug adapter modules, formatters, linters and LSP servers.
Attention board
Agents publish focus and get alignment scores or coordination decisions.

Good for

  • Give an agent your editor's diagnostics and definitions
  • Format a file with your own formatter pipeline and read the result
  • List which linters and LSP servers your config defines
  • Coordinate two agents so they do not work the same target

Pricing

Open source

Prices change. Check qompass.ai before you buy.

Periscope FAQ

Does it modify files?

No. Formatting is applied to the brokered buffer and returned as text; written is always false.

Will it disturb my open editor?

Managed mode runs its own headless Neovim, and attach mode never signals or closes an editor it did not spawn.

What does it ship as?

A Linux x64 MCPB bundle from the v1.0.0 release; the README describes a single Rust binary.

What is the attention feature?

A coordination board where agents publish an ordered focus and request alignment scores or decisions (MATE protocol).

Is Periscope free?

Yes. Periscope is open source, so you can use and self-host it for free.

How do I add Periscope to Claude Code?

Run this command in your terminal: claude mcp add periscope -- npx -y https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb

What are the best alternatives to Periscope?

The closest alternatives to Periscope are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Periscope

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools