Symbols MCP

Codebasis-Symbole lesen, inspizieren und navigieren durch Verbindung mit Language Servern.

Einführung

Durch die Verbindung mit einem Language Server Ihrer Wahl macht dieser MCP-Server es für Coding-Agenten einfach und effizient, die Codebasis und ihre Abhängigkeiten zu erkunden und zu navigieren. Der Server bietet eine minimale Menge an Tools, Ressourcen und Fähigkeiten, die einfach zu bedienen sind und den Kontext des Modells schonen.

Tools

• outline: gibt eine Übersicht der Codesymbole in einer Datei zurück, optional mit einem kleinen Code-Ausschnitt

• inspect: gibt Dokumentationen, Deklarations- und Implementierungsorte für ein Symbol zurück, einschließlich solcher von Drittanbietern

• search: sucht nach übereinstimmenden Symbolen in der gesamten Codebasis

• references: findet alle Referenzen eines Symbols in der gesamten Codebasis

• call_hierarchy: gibt eingehende und ausgehende Aufrufbeziehungen für ein aufrufbares Symbol zurück

• rename: benennt alle Referenzen eines Symbols in der gesamten Codebasis um

• diagnostics: gibt aktive Diagnosen in einer bestimmten Datei zurück

• completion: gibt kontextbezogene Vervollständigungen an einem bestimmten Ort zurück

• reload: lädt die effektive Konfiguration neu und wendet sie auf die aktuell laufenden Language Server an

Ressourcen

• language-servers://profiles: gibt die konfigurierten Language Server zusammen mit ihrem Status zurück.

• language-servers://profiles/{name}: gibt eine detailliertere Ansicht eines Language Servers zurück.

• language-servers://profiles/{name}/logs: gibt die Language Server-Protokolle zur Fehlerbehebung zurück.

Fähigkeiten

• install-language-server: installiert, konfiguriert, validiert oder behebt Fehler eines Language-Server-Profils für den aktuellen Arbeitsbereich.

• language-server-navigation: leitet die Symbolinspektion, Referenzen, Umbenennung, Diagnosen und Suche durch Language Server-Tools, bevor auf die Textsuche zurückgegriffen wird.

Related MCP server: Serena

Installation

Agenten-Installation

Installieren Sie den MCP-Server, die Agenten-Fähigkeiten über Plugins und Erweiterungen und bitten Sie dann den Agenten, einen relevanten Language Server für die Codebasis zu installieren.

• Erweiterung hinzufügen: gemini extensions install p1va/symbols

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

• MCP-Server hinzufügen: codex mcp add language-servers -- npx -y @p1va/symbols@latest start

• Language Server-Fähigkeiten hinzufügen: npx skills add p1va/symbols -a codex

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

Manuelle Installation

Für manuelle Konfiguration und Language Server-Beispiele siehe hier.

Entwicklung

• pnpm lint gibt die Lint-Verstöße aus

• pnpm lint:fix versucht, Lint-Verstöße zu beheben

• pnpm format formatiert die Codebasis

• pnpm dev startet im Entwicklungsmodus

• pnpm build führt den Linter und Build aus

• pnpm start startet die gebauten Artefakte

• pnpm test:unit führt die Unit-Tests aus

• pnpm test:integration:{language id} führt die Integrationstests für eine bestimmte Sprache aus

Veröffentlichung

• pnpm sync:skills spiegelt .agents/skills/ in:

  • skills/ für die Gemini-Erweiterung

  • plugins/symbols/skills/ für das Codex-Plugin.

• pnpm version patch erhöht die Version und erstellt das Tag. Dann:

  • pnpm sync:version aktualisiert Plugin- und Erweiterungs-Manifeste.

  • git push --follow-tags pusht den Commit und das Tag.