Symbols MCP

Lee, inspecciona y navega a través de los símbolos de la base de código conectándote a servidores de lenguaje (Language Servers).

Introducción

Al conectarse a un servidor de lenguaje de su elección, este servidor MCP facilita y hace eficiente que los agentes de codificación exploren y naveguen por la base de código y sus dependencias. El servidor ofrece un conjunto mínimo de herramientas, recursos y habilidades destinados a ser fáciles de usar y ligeros para el contexto del modelo.

Herramientas

• outline: devuelve un esquema de los símbolos de código en un archivo, opcionalmente con un pequeño fragmento de código

• inspect: devuelve documentación, declaraciones y ubicaciones de implementación para un símbolo, incluidos los de terceros

• search: busca símbolos coincidentes en toda la base de código

• references: encuentra todas las referencias de un símbolo en toda la base de código

• call_hierarchy: devuelve las relaciones de llamadas entrantes y salientes para un símbolo invocable

• rename: cambia el nombre de todas las referencias de un símbolo en toda la base de código

• diagnostics: devuelve los diagnósticos activos en un archivo determinado

• completion: devuelve autocompletados contextuales en una ubicación determinada

• reload: recarga la configuración efectiva y la vuelve a aplicar a los servidores de lenguaje que se están ejecutando actualmente

Recursos

• language-servers://profiles: devuelve los servidores de lenguaje configurados junto con su estado.

• language-servers://profiles/{name}: devuelve una vista más detallada de un servidor de lenguaje.

• language-servers://profiles/{name}/logs: devuelve los registros del servidor de lenguaje para la resolución de problemas.

Habilidades

• install-language-server: instala, configura, valida o soluciona problemas de un perfil de servidor de lenguaje para el espacio de trabajo actual.

• language-server-navigation: guía la inspección de símbolos, referencias, cambios de nombre, diagnósticos y búsquedas a través de las herramientas del servidor de lenguaje antes de recurrir a la búsqueda de texto.

Related MCP server: Serena

Instalación

Instalación del Agente

Instala el servidor MCP, las habilidades del agente a través de complementos y extensiones, y luego pide al agente que instale cualquier servidor de lenguaje relevante para la base de código.

• Añadir extensión: gemini extensions install p1va/symbols

• Preguntar a Gemini: Please install the language servers relevant to this codebase

• Añadir servidor MCP: codex mcp add language-servers -- npx -y @p1va/symbols@latest start

• Añadir habilidades de servidor de lenguaje: npx skills add p1va/symbols -a codex

• Preguntar a Codex: Please install the language servers relevant to this codebase

Instalación manual

Para obtener ejemplos de configuración manual y servidores de lenguaje, consulta aquí.

Desarrollo

• pnpm lint muestra las violaciones de lint

• pnpm lint:fix intenta corregir las violaciones de lint

• pnpm format formatea la base de código

• pnpm dev inicia en modo de desarrollo

• pnpm build ejecuta el linter y la compilación

• pnpm start inicia los artefactos compilados

• pnpm test:unit ejecuta las pruebas unitarias

• pnpm test:integration:{language id} ejecuta las pruebas de integración para un lenguaje determinado

Lanzamiento

• pnpm sync:skills para reflejar .agents/skills/ en:

  • skills/ para la extensión de Gemini

  • plugins/symbols/skills/ para el complemento de Codex.

• pnpm version patch para aumentar la versión y crear la etiqueta. Luego:

  • pnpm sync:version para actualizar los manifiestos del complemento y la extensión.

  • git push --follow-tags para enviar el commit y la etiqueta.