コーディングエージェントの決定事項とその制約をローカルのSQLiteデータベースに記録し、過去の経緯を追跡して古い決定を上書きできるようにします。
別名 LearningNodes/Elen, @learningnodes/elen-mcp
- スター
- 4
- ツール
- 12
- ダウンロード数(30日間)
- 257
- 最新バージョン
- 0.3.1
- 最終コミット
- 2026年10月20日
- ライセンス
- AGPL-3.0
elen MCPとは
elenはMCPサーバーです。 コーディングエージェントの決定事項とその制約をローカルのSQLiteデータベースに記録し、過去の経緯を追跡して古い決定を上書きできるようにします。. 12個のツールを提供しており、elen_commit, elen_get_competency, elen_consolidateなどがあります。
プロジェクトのREADMEから生成された概要
elen MCP server について
Elenは、コーディングエージェントが技術的な選択とその根拠となった制約をメモリとして保持するための手段を提供します。通常 ~/.elen/decisions.db に配置されるローカルのSQLiteデータベースを使用することで、エージェントは過去の経緯を追跡し、要件が変更された際にそれらを更新できます。これにより、エージェントが過去のミスを繰り返したり、確立されたプロジェクトルールを無視したりすることを防ぎます。
開発者は npx を使用して、Cursor、Claude Code、VS Code、Gemini CLI を含むさまざまな環境にこのサーバーを統合できます。システムは主にローカルモードで動作しますが、APIキーを必要とする接続モードが現在ベータ版として提供されています。このサーバーは、新しい決定を保存する elen_commit や、古い決定を期限切れとしてマークする elen_supersede といった特定のツールを提供します。
サーバーを最大限に活用するには、システムプロンプトに特定の指示を含める必要があります。これにより、エージェントが新しい方針を決定する前に、elen_suggest を使用して既存の経緯を見つけ、elen_expand を使用して詳細を確認できるようになります。また、ツールセットには、エージェントの検証済み決定履歴を表示する elen_get_competency も含まれています。
できること
- 1技術的なエラーの繰り返しを防止するエージェントが過去の技術的な選択を検索することで、新しい決定が確立された経緯と矛盾しないようにできます。
- 2古いプロジェクトルールの更新新しい要件によって以前の選択が無効になった場合、エージェントは古い決定を superseded(上書き)としてマークできます。
- 3技術的な制約のドキュメント化開発者はエージェントに対し、パフォーマンス予算などの特定の制限を、すべての新しい決定とともに記録するように指示できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
elen MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude Codeにelen MCPをインストール
$ claude mcp add elen -- npx -y @learningnodes/elen-mcpCursorにelen MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"elen": {
"command": "npx",
"args": [
"-y",
"@learningnodes/elen-mcp"
]
}
}
}VS Codeにelen MCPをインストール
.vscode/mcp.json
{
"servers": {
"elen": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@learningnodes/elen-mcp"
]
}
}
}VS Code CLIにelen MCPをインストール
$ code --add-mcp '{"name":"elen","type":"stdio","command":"npx","args":["-y","@learningnodes/elen-mcp"]}'Claude Desktopにelen MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"elen": {
"command": "npx",
"args": [
"-y",
"@learningnodes/elen-mcp"
]
}
}
}Codexにelen MCPをインストール
$ codex mcp add elen -- npx -y @learningnodes/elen-mcpCodex config.tomlにelen MCPをインストール
~/.codex/config.toml
[mcp_servers.elen] command = "npx" args = ["-y", "@learningnodes/elen-mcp"]
Gemini CLIにelen MCPをインストール
$ gemini mcp add -s user elen npx -- -y @learningnodes/elen-mcpGemini settings.jsonにelen MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"elen": {
"command": "npx",
"args": [
"-y",
"@learningnodes/elen-mcp"
]
}
}
}elen MCPツール 12
READMEから検出elen_commitelen_get_competencyelen_consolidateelen_get_contextelen_expandelen_incomingelen_log_decisionelen_search_precedentselen_statuselen_suggestelen_supersedeelen_team_search
| elen_commit | — | |
| elen_get_competency | — | |
| elen_consolidate | — | |
| elen_get_context | — | |
| elen_expand | — | |
| elen_incoming | — | |
| elen_log_decision | — | |
| elen_search_precedents | — | |
| elen_status | — | |
| elen_suggest | — | |
| elen_supersede | — | |
| elen_team_search | — |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るElen is an open-source MCP server that records the decisions your coding agent makes, with the limits that bound them, and marks old decisions as superseded. It installs with one npx line, works with Cursor, Claude Code and any MCP client, and keeps decisions in a local SQLite file.
Install
npx -y @learningnodes/elen-mcp@0.3.1
Claude Code
claude mcp add --transport stdio elen -- npx -y @learningnodes/elen-mcp@0.3.1
VS Code
Open this link to install:
vscode:mcp/install?%7B%22name%22%3A%22elen%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40learningnodes%2Felen-mcp%400.3.1%22%5D%7D
Cursor
Add this to .cursor/mcp.json in your project:
{
"mcpServers": {
"elen": {
"command": "npx",
"args": ["-y", "@learningnodes/elen-mcp@0.3.1"]
}
}
}
Gemini CLI
Add this to settings.json (~/.gemini/settings.json, or .gemini/settings.json in your project):
{
"mcpServers": {
"elen": {
"command": "npx",
"args": ["-y", "@learningnodes/elen-mcp@0.3.1"]
}
}
}
Any other MCP client
Use the same mcpServers entry:
{
"mcpServers": {
"elen": {
"command": "npx",
"args": ["-y", "@learningnodes/elen-mcp@0.3.1"]
}
}
}
Tested with
| Client | Status |
|---|---|
| Claude Code | Run by the maintainer |
| Cursor | Configuration follows the client's documentation. Not yet recorded as tested. |
| VS Code | Configuration follows the client's documentation. Not yet recorded as tested. |
| Gemini CLI | Configuration follows the client's documentation. Not yet recorded as tested. |
| Other MCP clients | Configuration follows the client's documentation. Not yet recorded as tested. |
Make your agent use it
The tools alone give an agent no habit: it sees what each tool does, but it does not stop mid-task to ask whether a precedent exists. Add the block below to your rules file or system prompt so that searching before a decision and committing after one become part of every session.
# Epistemic Decision Memory Protocol
You must adhere to the Minimal Token Protocol for decisions:
1. Pointer-First Retrieval: Before making a technical decision, ALWAYS use elen_suggest to retrieve Top-K minimal pointers.
2. On-Demand Expansion: If a pointer looks relevant, you MUST call elen_expand on that specific ID. Do not hallucinate constraints.
3. Commiting Atoms: When deciding, use elen_commit. Summarize constraints into plain-text arrays (e.g. "budget < 500ms").
4. Graph Revision: If a decision invalidates a precedent, you MUST use elen_supersede to advance the graph state.
What it stores
In local mode decisions stay in a SQLite file on your machine (default ~/.elen/decisions.db). Connected mode is optional, needs elen login and an API key, and is in beta.
Tools
| Tool | What it does |
|---|---|
elen_commit |
Commits a new decision to the graph, with its constraints as a plain-text list. |
elen_get_competency |
Shows the competency profile for this agent, built from its validated decision history. |
elen_consolidate |
Suggests clusters and duplicate or stale candidates without changing the graph. |
elen_get_context |
Gives an overview of active decision threads grouped by domain, for the start of a session. |
elen_expand |
Expands a decision ID into its full constraints and text. |
elen_incoming |
Lists decisions other people have shared into your workspace. Connected mode, beta. |
elen_log_decision |
Creates a validated Decision Record from constraints, evidence and an answer. |
elen_search_precedents |
Searches validated decisions for precedents. |
elen_status |
Returns the agent, project, database path and counts, to check the namespace before committing. |
elen_suggest |
Retrieves short pointers to prior decisions before you make a new one. |
elen_supersede |
Revises an older decision and marks it superseded by a new one. |
elen_team_search |
Searches team and human decisions visible to your workspace for a topic. Connected mode, beta. |
Links
- Repository: https://github.com/LearningNodes/Elen
- Issues: https://github.com/LearningNodes/Elen/issues
- Discord: https://discord.gg/zJG6n2WGzM
- Licence: AGPL-3.0
Elen is the open-source part of Learning Nodes, the DecisionOps workspace. For the business decisions behind the code: https://workstation.learningnodes.com?utm_source=elen-readme&utm_medium=referral&utm_campaign=npm-page
elen MCPのよくある質問
elen MCPをClaude Codeに追加するには
ターミナルでclaude mcp add elen -- npx -y @learningnodes/elen-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
elen MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
elen MCPが提供するツールは
12個のツールを提供しており、elen_commit, elen_get_competency, elen_consolidate, elen_get_context, elen_expandなどがあります。
決定事項はどこに保存されますか?
決定事項は、デフォルトで ~/.elen/decisions.db にあるローカルのSQLiteファイルに保存されます。
Claude Codeで動作しますか?
はい、Claude Codeと互換性があり、メンテナーによる動作確認も済みです。
エージェントに elen を使用させるにはどうすればよいですか?
エージェントのルールファイルやシステムプロンプトに、特定の「Epistemic Decision Memory Protocol」ブロックを追加してください。これにより、エージェントが決定事項を検索し、記録できるようになります。
クラウドや接続モードはありますか?
はい、ベータ版として接続モードが用意されています。利用には elen へのログインとAPIキーが必要です。