de en es ja ko ru zh

CogMemory MCP Server

Name: CogMemory MCP Server
Author: skylarng89

by skylarng89

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

CogMemory MCP サーバー

AI コーディングエージェント向けに4つのコンテキストサブシステムを提供する統合 Model Context Protocol サーバー：

メモリ — 決定、規約、エラー、アクティブコンテキスト、変更ログ、計画、タスク、セッション
ナレッジグラフ — エンティティ、リレーション、オブザベーション
スペック — 長文ドキュメント（PRD/SRS）、KGエンティティへのオプションリンク付き
コードグラフ — 静的構造グラフ（シンボル/エッジ）+ 名前付き実行トレース + AI生成アノテーション

ストレージ：SQLite（better-sqlite3 使用）。スコープごとに1つの .db ファイル。

クイックスタート

インストール

git clone <repo> && cd cogmemory-mcp
pnpm install
pnpm run build

VS Code での設定

.vscode/mcp.json（ワークスペーススコープ）に追加：

{
  "servers": {
    "cogmemory": {
      "command": "node",
      "args": ["/absolute/path/to/cogmemory-mcp/dist/index.js"]
    }
  }
}

または、グローバルで利用するにはユーザー mcp.json に追加します。

MCP Inspector での実行（開発用）

pnpm run inspect

Related MCP server: LumenCore

スコープ設定

CogMemory は以下の優先順位でスコープを解決します：

ワークスペースルートの .cogmemory/config.json：
```
{ "scope": "global" }
```
環境変数：COGMEMORY_SCOPE=global
デフォルト：workspace

パス

スコープ	データベースパス
workspace	`<workspace_root>/.cogmemory/memory.db`
global	`~/.cogmemory/global.db`

ワークスペース解決とマルチルートサポート

CogMemory はワークスペースルート（.cogmemory/memory.db が配置される場所）を以下の優先順位で解決します：

--workspace <path> CLI 引数（最優先）
COGMEMORY_WORKSPACE 環境変数
CWD からの遡及検索 — .cogmemory/ ディレクトリを含む最も近い親ディレクトリを検索
CWD へのフォールバック

マルチルート VS Code ワークスペース

VS Code のマルチルートワークスペースでは、各フォルダが独立したワークスペースルートとなります。CogMemory はこれを次のように処理します：

シングルルート — 自動的に動作。VS Code は CWD をワークスペースフォルダに設定し、--workspace は mcp.json を介して渡されます。
マルチルート — 各ワークスペースフォルダは独自の .cogmemory/ を持つことができます。それぞれ異なる --workspace パスで CogMemory を指定するか、親ディレクトリに共有の .cogmemory/ を配置します。

推奨されるマルチルート mcp.json（フォルダごと）：

{
  "servers": {
    "cogmemory-frontend": {
      "command": "node",
      "args": [
        "/path/to/cogmemory-mcp/dist/index.js",
        "--workspace",
        "/path/to/frontend"
      ]
    },
    "cogmemory-backend": {
      "command": "node",
      "args": [
        "/path/to/cogmemory-mcp/dist/index.js",
        "--workspace",
        "/path/to/backend"
      ]
    }
  }
}

または共有データベースを使用（すべてのルートを1か所に）：

{
  "servers": {
    "cogmemory": {
      "command": "node",
      "args": [
        "/path/to/cogmemory-mcp/dist/index.js",
        "--workspace",
        "/shared/root"
      ]
    }
  }
}

またはグローバルスコープを使用して、すべてのワークスペース間で共有：

{
  "servers": {
    "cogmemory": {
      "command": "node",
      "args": ["/path/to/cogmemory-mcp/dist/index.js"]
    }
  }
}

export COGMEMORY_SCOPE=global

ツールリファレンス

メモリツール

ツール	説明
`start_session`	ワークセッションを開始（セッションIDを返す）
`end_session`	セッションを終了し、サマリーを保存
`get_session_summary`	決定、エラー、変更ログを含むセッション詳細を呼び出す
`remember_decision`	根拠とタグ付きで決定を記録
`remember_convention`	規約を記録/更新（デザイントークン、パターン、命名規則など）
`log_error`	シグネチャと解決策付きでエラーを記録
`set_active_context`	現在のフォーカス/タスクをキーでアップサート
`get_active_context`	現在のフォーカスをキーで読み取り
`log_change`	変更ログエントリを追加
`add_plan_item`	ロードマップ項目を追加
`update_plan_status`	プラン項目のステータスを変更
`create_task`	タスクを作成（プランへのオプションリンク付き）
`update_task_status`	タスクのステータスを変更
`recall`	決定/規約/エラー/変更ログを横断した統合検索

ナレッジグラフツール

ツール	説明
`create_entity`	エンティティを追加（name+type で重複排除）
`create_relation`	2つのエンティティを型付きリレーションでリンク
`add_observation`	エンティティにファクトを添付
`search_knowledge`	エンティティ、リレーション、オブザベーションを検索

スペックツール

ツール	説明
`create_spec`	長文ドキュメントを保存
`get_spec`	IDまたは完全なタイトルで取得
`update_spec`	コンテンツ/タイトルを更新（バージョン自動更新）

コードグラフツール

ツール	説明
`index_codebase`	ワークスペースを走査し、ts-morph でシンボル+エッジを抽出（JS/TS）
`query_code_graph`	シンボルの呼び出し元/呼び出し先（1ホップ）を検索
`generate_codemap`	エントリシンボルから BFS、オプションのトレース+アノテーション付きで有界サブグラフを生成
`annotate_symbol`	シンボルまたはトレースにナラティブテキストを添付

アーキテクチャ

cogmemory-mcp/
├── src/
│   ├── index.ts                 # entry point, server bootstrap
│   ├── config.ts                # scope resolution, path resolution
│   ├── types.ts                 # shared TS types mirroring schema
│   ├── db/
│   │   ├── connection.ts        # DB open/close, pragma setup
│   │   ├── schema.sql           # full schema (reference)
│   │   └── migrate.ts           # idempotent schema application
│   ├── tools/
│   │   ├── memory.ts            # decisions/conventions/errors/context/changelog/recall
│   │   ├── plan-tasks.ts        # plan + tasks tools
│   │   ├── sessions.ts          # start/end session, summary
│   │   ├── knowledge-graph.ts   # entities/relations/observations
│   │   ├── specs.ts             # spec CRUD
│   │   ├── code-graph.ts        # index_codebase, query_code_graph
│   │   └── codemap.ts           # generate_codemap, annotate_symbol
│   └── indexing/
│       ├── ts-analyzer.ts       # ts-morph symbol/edge extraction
│       └── walker.ts            # file discovery, gitignore respect
├── schema.sql                   # reference copy
├── package.json
├── tsconfig.json
└── README.md

スキーマ（15テーブル）

メモリ（8）： sessions、decisions、conventions、errors、context、changelog、plan、tasks
ナレッジグラフ（3）： entities、relations、observations
スペック（1）： specs
コードグラフ（4）： symbols、edges、execution_traces、codemap_annotations

プラグマ

接続を開くたびに設定：

PRAGMA journal_mode = WAL;
PRAGMA foreign_keys = ON;

開発

pnpm run dev        # Run with tsx (no build step)
pnpm run build      # Compile TypeScript
pnpm run start      # Run compiled output
pnpm run inspect    # Launch MCP Inspector
pnpm run smoke-test # Run smoke test script

ライセンス

MIT

This server cannot be deployed

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

TeamShared C
io.github.xhad
Shared memory for coding agents. Stop re-explaining your codebase every session.
Knowledge & Memory Developer Tools
1001
Penfield Memory AOAuth
io.github.penfieldlabs
Persistent memory and knowledge graphs for AI agents. Hybrid search, context checkpoints, and more.
Knowledge & Memory RAG Systems Vector Databases
1726
ContextStream MCP ServerOAuth
io.github.contextstream
Project memory, semantic code search, and grounded agent context.
Knowledge & Memory Code Analysis RAG Systems
144
FairMind Project Context
ai.fairmind
Project memory for coding agents: requirements, decisions, code graph and delivery telemetry.
Knowledge & Memory Code Analysis
1

Related MCP Servers

DevFlow MCP
Knowledge & Memory Developer Tools Autonomous Agents
Takin-Profit
A
license
Not graded
quality
D
maintenance
Provides AI agents with persistent, searchable memory using a knowledge graph stored in SQLite. Features semantic search, temporal awareness, and workflow-aware prompts for development projects.
Updated a year ago (2025-11-03 16:28 UTC)
7 npm
MIT
LumenCore
Knowledge & Memory Developer Tools Autonomous Agents
arclightdynamics
A
license
Not graded
quality
D
maintenance
Provides AI coding assistants with persistent project memory to retain architectural decisions, code patterns, and domain knowledge across sessions. It stores data locally in a SQLite database, allowing agents to remember, recall, and manage project-specific context using full-text search.
Updated 4 months ago (2026-06-14 18:44 UTC)
8 npm
Apache 2.0
Memory MCP
Knowledge & Memory Developer Tools
nerdyaustin
A
license
A
quality
B
maintenance
Provides persistent cross-session memory and full-text search for AI coding assistants, storing project context, decisions, and preferences while enabling searchable access to conversation history via local SQLite.
Updated 2 months ago (2026-08-04 18:57 UTC)
8
1
MIT
Context-MCP
yesheng-oss
A
license
A
quality
B
maintenance
Acts as a persistent memory and cross-tool shared context store, and builds a queryable codebase knowledge graph to slash token usage via structural answers.
Updated a month ago (2026-09-05 04:05 UTC)
9
37 npm
19
MIT