Periscope
Rust MCP broker into a live Neovim config for LSP, formatters, linters and DAP
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools