Serena

セレナは強力なオープンソースのコーディングエージェントツールキットで、大規模言語モデル（LLM）をコードベース上で直接動作するフル機能のエージェントに変えることができます。IDEに似た意味論的なコード検索と編集ツールを提供し、様々なプログラミング言語をサポートし、MCPプロトコルまたはAgnoフレームワークを介して様々なLLMと統合することができます。

開発者ツール人工知能チャットボット #コーディングエージェント #意味論的分析 #オープンソースツール #多言語サポート .Python

スコア : 5ポイント

ダウンロード数 : 36.6K

更新時間 : 2025-04-29

サイトを開く

セレナとは？

セレナはModel Context Protocol (MCP)に基づくコーディングエージェントツールキットで、大規模言語モデル（LLM）をコードベースを直接操作できるフル機能のエージェントに変えます。セレナは、IDEに似た機能である意味論的なコード検索と編集ツールを提供し、シンボルレベルでコードエンティティを抽出し、関係構造を利用することができます。

セレナの使い方は？

セレナはいくつかの方法で使用できます：1) Claude DesktopをMCPサーバーとして使用する 2) Agnoフレームワークを介して様々なLLMと統合する 3) IDEプラグインまたはCLIツールを使用する。

適用シナリオ

セレナは、コード分析、計画、新しいコンポーネントの設計または既存のコンポーネントのリファクタリングなど、あらゆるコーディングタスクに適しています。初期分析から実装、テスト、最後のバージョン管理システムへのコミットまで、コーディングタスクを自主的に完了することができます。

主要機能

意味論的なコード検索

IDEに似たシンボルレベルのコードクエリ機能を提供し、コード構造と関係を理解することができます。

コード編集

シンボルレベルのコード編集操作（コードブロックの挿入、置換、削除など）をサポートします。

多言語サポート

Python、Java、TypeScriptなどの様々なプログラミング言語をサポートします。

多モデル統合

MCPプロトコルまたはAgnoフレームワークを介して様々なLLMと統合することができます。

利点

無料でオープンソースであり、サブスクリプション料金は必要ありません。

様々なプログラミング言語とLLMモデルをサポートします。

シンボルレベルのコード理解と編集能力を提供します。

分析から実装までの完全なコーディングタスクを自主的に完了することができます。

制限

言語サーバーを構成する必要があり、一部の言語では起動が遅い場合があります。

IDEとの直接統合は、専用のIDEプラグインほど緊密ではありません。

一部の高度な機能を構成するには技術的な知識が必要な場合があります。

使い方

インストールと構成

uvツールをインストールし、セレナのリポジトリをクローンし、構成ファイルをコピーして調整します。

プロジェクト構成の設定

各プロジェクトにproject.yml構成ファイルを作成します。

Claude Desktopとの統合

Claude DesktopがセレナをMCPサーバーとして使用するように構成します。

使用例

新機能の実装

セレナは既存のコードベースを分析し、新機能を設計して実装することができます。

コードリファクタリング

セレナはコード内の問題を識別し、リファクタリングの提案を行うことができます。

よくある質問

セレナはどのプログラミング言語をサポートしていますか？

MCPサーバーの起動問題をどう解決しますか？

セレナは安全ですか？私のコードを変更しますか？

🚀 Serenaの使用方法

Serenaは、開発プロセスを支援するためのツールです。このドキュメントでは、Serenaのインストール、初期化、使用方法、カスタマイズ、トラブルシューティングについて説明します。

🚀 クイックスタート

インストールと初期化

依存関係のインストール：INSTALL.mdファイルの指示に従って、Python、Node.js、Yarnをインストールしてください。

仮想環境の作成とパッケージのインストール：

python -m venv .venv && source .venv/bin/activate  # macOS/Linuxの場合
pip install -r requirements.txt

プロジェクトの初期化：

uv init your_project_name
cd your_project_name

言語サービスの起動

プロジェクトディレクトリで以下のコマンドを実行して、Serenaの言語サービスを起動します。

uv run serena

✨ 主な機能

プロジェクトのアクティブ化と管理

プロジェクトの切り替え：
```
uv run serena activate <project_name>
```

プロジェクトの削除：

uv run serena delete-project <project_name>

ファイル操作

ファイルの作成：
```
uv run serena create-file <filename>
```
ファイル内容の読み取り：
```
uv run serena read-file <filepath>
```
ファイルの削除：
```
uv run serena delete-file <filepath>
```

コード操作

シンボルの検索：

uv run serena find-symbol <symbol_name>

コードスニペットの挿入：

uv run serena insert-code <position> --content <code_content>

コードセグメントの置換：

uv run serena replace-lines <start_line>:<end_line> --content <new_content>

プロジェクトのビルドとテスト

テストの実行：
```
uv run serena run-tests
```
プロジェクトのビルド：
```
uv run serena build
```

🔧 カスタム設定

新しいツールの作成

新しいツールクラスファイルの作成：new_tool.pyという名前のファイルを作成し、以下の内容を追加します。

class NewTool(Tool):
    def apply(self, context: Context) -> Context:
        # ここにツールのロジックを実装します
        return context

新しいツールの登録：
- serena/agent/tools/__init__.pyファイルを編集し、以下の内容を追加します。
```
from .new_tool import NewTool

__all__ = ['NewTool']
```

🛠️ トラブルシューティング

問題のトラブルシューティング手順

ログの確認：言語サービスの出力ログを確認して、詳細な情報を取得してください。
サービスの再起動：
```
uv run serena restart-language-server
```
プロジェクトの再初期化：
```
uv init your_project_name
```

📚 ドキュメント

完全なツールリスト

以下は、Serenaのすべてのツールとその簡単な説明です（uv run serena-list-toolsを実行することで取得できます）。

activate_project: 指定された名前のプロジェクトをアクティブ化します。
check_onboarding_performed: 初期化プロセスが完了しているかどうかを確認します。
create_text_file: プロジェクトディレクトリ内にファイルを作成/上書きします。
delete_lines: ファイル内の指定された範囲の行を削除します。
delete_memory: Serenaのプロジェクト固有のストレージからメモリを削除します。
execute_shell_command: shellコマンドを実行します。
find_referencing_code_snippets: 与えられた位置のシンボルを参照するコードスニペットを検索します。
find_referencing_symbols: 与えられた位置のシンボルを参照する他のシンボルを検索します（オプションでフィルタリングするタイプを指定できます）。
find_symbol: プロジェクト内で、指定された文字列を含む名前のシンボルをグローバルまたはローカルに検索します。
get_active_project: 現在アクティブなプロジェクトの名前を取得し（存在する場合）、すべてのプロジェクトをリストします。