Symbols MCP

言語サーバーに接続して、コードベースのシンボルを読み取り、調査し、ナビゲートします。

はじめに

任意の言語サーバーに接続することで、このMCPサーバーはコーディングエージェントがコードベースとその依存関係を簡単かつ効率的に探索・ナビゲートできるようにします。 このサーバーは、使いやすく、モデルのコンテキストを圧迫しない、最小限のツール、リソース、スキルを提供します。

ツール

• outline: ファイル内のコードシンボルのアウトラインを返します（オプションで小さなコードスニペットを含めることも可能）

• inspect: サードパーティ製のものを含む、シンボルのドキュメント、宣言、および実装場所を返します

• search: コードベース全体で一致するシンボルを検索します

• references: コードベース全体でシンボルのすべての参照を検索します

• call_hierarchy: 呼び出し可能なシンボルの着信および発信の呼び出し関係を返します

• rename: コードベース全体でシンボルのすべての参照の名前を変更します

• diagnostics: 指定されたファイルの現在のアクティブな診断情報を返します

• completion: 指定された場所のコンテキストに応じた補完を返します

• reload: 有効な設定を再読み込みし、現在実行中の言語サーバーに再適用します

リソース

• language-servers://profiles: 設定された言語サーバーとその状態を返します。

• language-servers://profiles/{name}: 特定の言語サーバーの詳細なビューを返します。

• language-servers://profiles/{name}/logs: トラブルシューティング用に言語サーバーのログを返します。

スキル

• install-language-server: 現在のワークスペース用の言語サーバープロファイルをインストール、設定、検証、またはトラブルシューティングします。

• language-server-navigation: テキスト検索にフォールバックする前に、言語サーバーツールを使用してシンボルの調査、参照、名前変更、診断、検索をガイドします。

Related MCP server: Serena

インストール

エージェントのインストール

MCPサーバーとエージェントスキルをプラグインおよび拡張機能経由でインストールし、エージェントにコードベースに関連する言語サーバーをインストールするよう依頼してください。

• 拡張機能の追加: gemini extensions install p1va/symbols

• Geminiへの依頼: Please install the language servers relevant to this codebase

• MCPサーバーの追加: codex mcp add language-servers -- npx -y @p1va/symbols@latest start

• 言語サーバースキルの追加: npx skills add p1va/symbols -a codex

• Codexへの依頼: Please install the language servers relevant to this codebase

手動インストール

手動設定と言語サーバーの例については、こちらを参照してください。

開発

• pnpm lint はリント違反を出力します

• pnpm lint:fix はリント違反の修正を試みます

• pnpm format はコードベースをフォーマットします

• pnpm dev は開発モードで起動します

• pnpm build はリンターを実行し、ビルドします

• pnpm start はビルドされたアーティファクトを起動します

• pnpm test:unit はユニットテストを実行します

• pnpm test:integration:{language id} は指定された言語の統合テストを実行します

リリース

• pnpm sync:skills は .agents/skills/ を以下にミラーリングします:

  • Gemini拡張機能用の skills/

  • Codexプラグイン用の plugins/symbols/skills/

• pnpm version patch はバージョンを上げてタグを作成します。その後:

  • pnpm sync:version はプラグインと拡張機能のマニフェストを更新します。

  • git push --follow-tags はコミットとタグをプッシュします。