io.github.p1va/symbols
MCP server to read, inspect and troubleshoot codebase symbols
Ask AI about io.github.p1va/symbols
Powered by Claude · Grounded in docs
I know everything about io.github.p1va/symbols. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Symbols MCP
Read, inspect and navigate through codebase symbols by connecting to Language Servers.
Introduction
By connecting to a Language Server of choice this MCP server makes it easy and efficient for coding agents to explore and navigate the codebase and its dependencies. The server offers a minimal set of tools, resources and skills intended to be simple to use and light on the model's context.
Tools
outline: returns an outline of code symbols in a file, optionally with a small code snippetinspect: returns docs, declaration and implementation locations for a symbol, including third-party onessearch: returns matching symbols across the codebasereferences: finds all references of a symbol across the codebasecall_hierarchy: returns incoming and outgoing call relationships for a callable symbolrename: renames all references of a symbol across the codebasediagnostics: returns active diagnostics in a given filecompletion: returns contextual completions at a given locationreload: reloads the effective config and reapplies it to currently running language servers
Resources
language-servers://profiles: returns the configured language servers along with their state.language-servers://profiles/{name}: returns a more detailed view of one language server.language-servers://profiles/{name}/logs: returns the Language Server logs for troubleshooting.
Skills
install-language-server: installs, configures, validates, or troubleshoots a language-server profile for the current workspace.language-server-navigation: guides symbol inspection, references, rename, diagnostics, and search through Language Server tools before falling back to text search.
Installation
Agent Installation
Install the MCP Server, Agent Skills via Plugins and Extensions and then ask the agent to install any relevant language server for the codebase.
Gemini
- Add Extension:
gemini extensions install p1va/symbols - Ask Gemini:
Please install the language servers relevant to this codebase
Codex
- Add MCP Server:
codex mcp add language-servers -- npx -y @p1va/symbols@latest start - Add Language Server Skills:
npx skills add p1va/symbols -a codex - Ask Codex:
Please install the language servers relevant to this codebase
Manual Installation
For manual configuration and language servers examples see here.
Development
pnpm lintoutputs the lint violationspnpm lint:fixattempts to fix lint violationspnpm formatformats the codebasepnpm devstarts in development modepnpm buildruns the linter and buildpnpm startstarts the built artifactspnpm test:unitruns the unit testspnpm test:integration:{language id}runs the integration tests for a given language
Release
pnpm sync:skillsto mirror.agents/skills/into:skills/for the Gemini Extensionplugins/symbols/skills/for the Codex Plugin.
pnpm version patchto bump the version and create the tag. Then:pnpm sync:versionto update plugin and extension manifests.git push --follow-tagsto push the commit and tag.
