{
  "markdown": "<div align=\"center\">\n\n# Symbols MCP\n\nRead, inspect and navigate through codebase symbols by connecting to Language Servers.\n\n![NPM Version](https://img.shields.io/npm/v/%40p1va%2Fsymbols?style=flat)\n\n</div>\n\n## Introduction\n\nBy 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.\nThe server offers a minimal set of tools, resources and skills intended to be simple to use and light on the model's context.\n\n### Tools\n\n- **`outline`**: returns an outline of code symbols in a file, optionally with a small code snippet\n- **`inspect`**: returns docs, declaration and implementation locations for a symbol, including third-party ones\n- **`search`**: returns matching symbols across the codebase\n- **`references`**: finds all references of a symbol across the codebase\n- **`call_hierarchy`**: returns incoming and outgoing call relationships for a callable symbol\n- **`rename`**: renames all references of a symbol across the codebase\n- **`diagnostics`**: returns active diagnostics in a given file\n- **`completion`**: returns contextual completions at a given location\n- **`reload`**: reloads the effective config and reapplies it to currently running language servers\n\n### Resources\n\n- **`language-servers://profiles`**: returns the configured language servers along with their state.\n- **`language-servers://profiles/{name}`**: returns a more detailed view of one language server.\n- **`language-servers://profiles/{name}/logs`**: returns the Language Server logs for troubleshooting.\n\n### Skills\n\n- **`install-language-server`**: installs, configures, validates, or troubleshoots a language-server profile for the current workspace.\n- **`language-server-navigation`**: guides symbol inspection, references, rename, diagnostics, and search through Language Server tools before falling back to text search.\n\n## Installation\n\n### Codex\n\n```bash\ncodex plugin marketplace add p1va/symbols\ncodex plugin add symbols@symbols\n```\n\nThen ask Codex:\n\n`Please install and configure the language servers relevant to this codebase`\n\n### Antigravity\n\n```bash\nagy plugin install https://github.com/p1va/symbols.git\n```\n\nThen ask Antigravity:\n\n> Install and configure the language servers relevant to this codebase.\n\n### Manual Installation\n\nFor manual configuration and language servers examples see [here](docs/INSTALLATION.md#traditional-installation).\n\n## Development\n\n- `pnpm lint` outputs the lint violations\n- `pnpm lint:fix` attempts to fix lint violations\n- `pnpm format` formats the codebase\n- `pnpm format:check` checks formatting without changing files\n- `pnpm dev` starts in development mode\n- `pnpm build` runs the linter and build\n- `pnpm start` starts the built artifacts\n- `pnpm test:unit` runs the unit tests\n- `pnpm test:integration:{language id}` runs the integration tests for a given language\n\n## Release\n\n- `pnpm version patch` to synchronize generated assets, bump the version, and\n  create a single commit and tag. Use `minor` or `major` when appropriate.\n- `git push --follow-tags` to push the commit and tag.\n\nThe version lifecycle checks formatting, mirrors `.agents/skills/` into the\nAntigravity and Codex distributions, and updates the versioned Codex plugin\nmanifest before the commit and tag are created.\n",
  "bytes": 3329,
  "sha": "897c833f96cee6b9028040d74017188b7ec1e51b680e654c1f10089ec316c2f8",
  "repo_slug": "p1va/symbols",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_p1va_symbols_7afc9392/readme"
}