Provides an agent memory infrastructure that enables LLMs to store, categorize, and recall information using four types of cognitive memory.
Also known as jee1/memento, memento-mcp-server
- Stars
- 0
- Tools
- โ
- Downloads, 30 days
- โ
- Latest version
- 2.3.10
- Last commit
- Nov 15, 2026
- License
- MIT
What is Memento MCP?
Memento provides an agent memory infrastructure that enables LLMs to store, categorize, and recall information using four types of cognitive memory.
Summary generated from the project's README
About Memento MCP server
Memento serves as a memory operating system for large language models, providing the infrastructure necessary to store and recall information across different sessions. It moves beyond simple storage by implementing a system where memories are generated, categorized, and reinforced. Developers can use this server to give agents long-term context through four specific cognitive types: working, episodic, semantic, and procedural memory.
The server can be deployed locally via npm or through Docker, and it integrates with clients like Claude Code, Cursor, and Claude Desktop. Users can set up the environment using npx or by installing the package globally to access the memento CLI. While the server registers 22 tools, it defaults to exposing only four core functions: recall, remember, memory_injection, and feedback to keep the interface clean. For advanced management, a separate HTTP API provides access to administrative features like memory migration and statistics.
What you can do with it
- 1Store long-term user contextAn AI agent can save specific user details or learned concepts into episodic or semantic memory for future sessions.
- 2Retrieve specific past informationA developer can instruct an AI to search through stored memories using natural language queries to find relevant context.
- 3Manage memory lifecycleThe system automatically handles the reinforcement of useful information and the removal of outdated data.
Written from the project's README. Every use case is checked against a quote from it.
How to install Memento MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Memento MCP in Claude Code
$ claude mcp add memento -- npx -y memento-mcp-serverInstall Memento MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"memento": {
"command": "npx",
"args": [
"-y",
"memento-mcp-server"
]
}
}
}Install Memento MCP in VS Code
.vscode/mcp.json
{
"servers": {
"memento": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"memento-mcp-server"
]
}
}
}Install Memento MCP in VS Code CLI
$ code --add-mcp '{"name":"memento","type":"stdio","command":"npx","args":["-y","memento-mcp-server"]}'Install Memento MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"memento": {
"command": "npx",
"args": [
"-y",
"memento-mcp-server"
]
}
}
}Install Memento MCP in Codex
$ codex mcp add memento -- npx -y memento-mcp-serverInstall Memento MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.memento] command = "npx" args = ["-y", "memento-mcp-server"]
Install Memento MCP in Gemini CLI
$ gemini mcp add -s user memento npx -- -y memento-mcp-serverInstall Memento MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"memento": {
"command": "npx",
"args": [
"-y",
"memento-mcp-server"
]
}
}
}Configuration
DB_PATH
| Name | Description | |
|---|---|---|
| DB_PATH | โ |
Automated checks
Ran Nov 14, 2026Full report โPassed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablejee1/memento is public and reachablegithub.com/jee1/memento โPass
- Package names this repository as its sourcememento-mcp-server names jee1/memento as sourcenpmjs.com/package/memento-mcp-server โPass
- Build provenance (Sigstore attestation)Sigstore attestation for memento-mcp-servernpmjs.com/package/memento-mcp-server/v/2.3.10#provenance โPass
- Open source license (OSI)MITspdx.org/licenses/MIT.html โPass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/jee1/memento โPass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from memento-mcp-serverPass
- No critical advisory in the package or its dependencies246 resolved dependencies checked; no critical advisoryosv.dev โPass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub๐ง Memento
๐ฐ๐ท ํ๊ตญ์ด | ๐บ๐ธ English
LLM์ ๋ํ๊ฐ ๋๋๋ฉด ๋ชจ๋ ๊ฒ์ ์์ต๋๋ค. ์ด๋ฆ๋, ๊ฒฐ์ ๋, ์ง๋์ฃผ์ ์์ธ ๋งฅ๋ฝ๋ ๋ง์ฐฌ๊ฐ์ง์ ๋๋ค. ์ด๋ ๋ชจ๋ธ์ ํ๊ณ๊ฐ ์๋๋ผ ๊ธฐ์ต ์ธํ๋ผ์ ๋ถ์ฌ์ ๋๋ค.
Memento๋ ๊ทธ ์ธํ๋ผ์ ๋๋ค. ๋จ์ ์ ์ฅ์๊ฐ ์๋๋ผ, ๊ธฐ์ต์ด ์์ฑยท๋ถ๋ฅยท๊ฐํยท๋ง๊ฐ๋๋ MCP ๊ธฐ๋ฐ ๊ธฐ์ต ์ด์ ์ฒด์ ์ ๋๋ค.
์์
๊ธฐ์ตยท์ผํ๊ธฐ์ตยท์๋ฏธ๊ธฐ์ตยท์ ์ฐจ๊ธฐ์ต์ remember์ type์ผ๋ก ๊ตฌ๋ถํฉ๋๋ค. ์ฐ์ธ ๊ธฐ์ต์ ๊ฐํ๋๊ณ , ์ธ๋ชจ์์ด์ง ๊ธฐ์ต์ ๋ง๊ฐ ์ ์ฑ
์ผ๋ก ์ ๋ฆฌ๋ฉ๋๋ค. ๋น์ทํ ๊ธฐ์ต์ ๋ฒกํฐ๋ก ์ฐ๊ฒฐ๋๋ฉฐ, ํต์ฌ ๋งฅ๋ฝ์ ์ต์ปค๋ก ๋ค์ ๋ํ์ ๋ฐ๋ก ๋ณต์๋ฉ๋๋ค.
๋ชจ๋ ธ๋ ํฌยทํจํค์ง ๊ตฌ์กฐยท๋น๋ ๋ช ๋ น์ AGENTS.md๋ฅผ ์ฐธ๊ณ ํด ์ฃผ์ธ์.
๋น ๋ฅธ ์์
ํจํค์ง ๋งค๋์ ๋ npm๋ง ์ง์ํฉ๋๋ค (pnpm/yarn์ ์ง์ํ์ง ์์ต๋๋ค).
์ญํ ์ ๋ง๋ ๊ธฐ๋ณธ ๊ฒฝ๋ก ํ๋๋ง ๊ณ ๋ฅด์ธ์. Dockerยท์์ค ํด๋ก ยท๋ค์ค ์์ด์ ํธ HTTPยท์ํด๋ฆญ ์คํฌ๋ฆฝํธ๋ INSTALL.md์ ์์ต๋๋ค.
Claude Code โ ํ๋ฌ๊ทธ์ธ
/plugin marketplace add jee1/memento
/plugin install memento@memento
๊ธฐ์ต DB๋ ${CLAUDE_PLUGIN_DATA}/memory.db์ ๋์ด ํ๋ฌ๊ทธ์ธ ์
๋ฐ์ดํธ ํ์๋ ์ ์ง๋ฉ๋๋ค. /plugin ํจ๋์์ memento MCP๊ฐ ์ฐ๊ฒฐ๋๋์ง ํ์ธํด ์ฃผ์ธ์.
memento hook claude-code์์ lifecycle ์บก์ฒ๋ฅผ ๋๊ณ ์ง์นจ ์ฃผ์
๋ง ์ฐ๋ ค๋ฉด MEMENTO_CAPTURE=0์ผ๋ก ์ค์ ํฉ๋๋ค (๊ธฐ๋ณธ๊ฐ: 1).
Cursorยท๊ธฐํ MCP โ npx + mcp.json
npx memento-mcp-server@latest
{
"mcpServers": {
"memento": {
"command": "npx",
"args": ["memento-mcp-server@latest"],
"env": {
"DB_PATH": "/absolute/path/to/data/memory.db"
}
}
}
}
์ค์ ํ์ผ ์์น๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค. Cursor๋ .cursor/mcp.json ๋๋ ~/.cursor/mcp.json์
๋๋ค. Claude DesktopยทClaude Code๋ INSTALL.md์ Cursor MCP ์ค์ ๊ฐ์ด๋๋ฅผ ์ฐธ๊ณ ํด ์ฃผ์ธ์.
MCP ์์ด ํฐ๋ฏธ๋์์๋ง memento CLI๋ฅผ ์ฐ๋ ์์ด์ ํธ๋ CLI agent skill(์์
์ /ํ recallยทremember ์ํฌํ๋ก)์ CLI for AI ๊ฐ์ด๋๋ฅผ ํจ๊ป ์ฐธ๊ณ ํด ์ฃผ์ธ์.
์์ฃผ ์ด๋ค๋ฉด npm i -g memento-mcp-server๋ก ๊ธ๋ก๋ฒ ์ค์นํ๋ ํธ์ด ๋ซ์ต๋๋ค. ๊ณต์ MCP ๋ ์ง์คํธ๋ฆฌ ์ด๋ฆ์ io.github.jee1/memento-mcp-server์
๋๋ค (server.json).
๊ธ๋ก๋ฒ ์ค์นํ๋ฉด memento CLI ๋ ํจ๊ป ๊น๋ฆฝ๋๋ค. memento connect claude-code ๊ฐ ๋ฑ๋กํ๋ memento hook claude-code ํ
์ด ์ด ๋ช
๋ น์ ์๋๋ค.
์ด์ยท์์ฒด ํธ์คํ โ INSTALL.md
Docker, ์์ค ๋น๋, HTTP MCP(๋ค์ค ์์ด์ ํธ), ํ๊ฒฝ ์ค๋ฒ๋ ์ด๋ INSTALL.md๋ฅผ ๋ฐ๋ผ ์ฃผ์ธ์.
๊ธฐ๋ณธ์ผ๋ก ๋ณด์ด๋ ๋๊ตฌ
์๋ฒ์๋ ๋๊ตฌ 22๊ฐ๊ฐ ๋ฑ๋ก๋์ด ์์ง๋ง, tools/list์๋ ๊ธฐ๋ณธ์ ์ผ๋ก recall ยท remember ยท memory_injection ยท feedback 4๊ฐ๋ง ๋
ธ์ถ๋ฉ๋๋ค(v1.18+). ๋๋จธ์ง๋ ๋ฑ๋ก๋ ์ฑ ํธ์ถ์ ๊ฐ๋ฅํ๊ณ , ๋ชฉ๋ก์์๋ง ๋น ์ง๋๋ค. ์ ๋ถ ๋์ดํ๋ ค๋ฉด MEMENTO_TOOLSET=full์ ์ค์ ํ์ธ์.
์ฌ์ฉ ์์
await client.callTool({
name: "remember",
arguments: {
content: "์ฌ์ฉ์๋ React Hook์ ํ์ตํ์ต๋๋ค. useState๋ ์ํ๋ฅผ ๊ด๋ฆฌํ๊ณ , useEffect๋ ์ฌ์ด๋ ์ดํํธ๋ฅผ ์ฒ๋ฆฌํฉ๋๋ค.",
type: "episodic",
tags: ["react", "hooks", "javascript"],
importance: 0.8
}
});
const results = await client.callTool({
name: "recall",
arguments: {
query: "React Hook์ ์ด๋ป๊ฒ ์ฌ์ฉํ๋์?",
limit: 5
}
});
๋ ๋ง์ ์ฐ๊ฒฐ ๋ฐฉ์(MCP SDK, @jee1/memento-client, ์ธ๋ถ ๋น์ SDK)์ docs/README.md์ docs/integrations/๋ฅผ ์ฐธ๊ณ ํด ์ฃผ์ธ์.
ํต์ฌ ๊ธฐ๋ฅ
- 4์ข
๊ธฐ์ต:
workingยทepisodicยทsemanticยทprocedural - ํ์ด๋ธ๋ฆฌ๋ ๊ฒ์: FTS5 + ๋ฒกํฐ, ํ๊ทธ ํํฐ
- ์ด์์๋ ๊ธฐ์ต: ๊ฐํยท๋ง๊ฐยท์ด์ ํ์ยท์ต์ปค
- ์ ์ฐจ ๋ฒ์ :
procedural_diff/procedural_rollback - Case ์ง์นจ ์ฃผ์
: Claude Code / Codex / Cursor ํ๋กฌํํธ๋ง๋ค ๊ด๋ จ ์ง์นจ๋ง ๊ณ ์ ์์ฐ์ผ๋ก ์ฃผ์
. ์๋ฒ
case๊ธฐ์ต ๋๋ ๋งํฌ๋ค์ด ํด๋ (MEMENTO_DIRECTIVES_CASES_DIR) (๊ฐ์ด๋) - ๊ทธ๋ํยท๋์๋ณด๋: HTTP ์๋ฒ ๊ธฐ๋ ํ ์ ์ฒด ๊ด๋ฆฌ ํ๋ฆ์
/dashboard์์ ์ฌ๋ ํธ์ด ๊ฐ์ฅ ์์ ํ๋ฉฐ,/graph๋ฅผ ์ง์ ์ด์ด๋ ๋์ผํ/auth/session๊ธฐ๋ฐ ์ฌ์ธ์ฆ ํจ๋๋ก ์ธ์ ์ ์์ํ๊ฑฐ๋ ๋ณต๊ตฌํ ์ ์์ต๋๋ค.
๋ง๊ฐ TTLยท์๋ฒ ๋ฉยท๋ณด์ ๋ฑ ์ค์ ๊ฐ์ README์ ์ซ์๋ฅผ ๋์ง ์์ต๋๋ค. env.example๊ฐ ๊ธฐ์ค์ ๋๋ค.
HTTP ๋ณด์ (๊ด๋ฆฌ ์๋ฒ)
HTTP ์๋ฒ๋ ๋ธ๋ผ์ฐ์ ์ธ์
๊ณผ ํค๋ ๊ธฐ๋ฐ ์ ๋ขฐ ๊ฒฝ๊ณ๋ฅผ ๋ถ๋ฆฌํฉ๋๋ค. /auth/session์ ์ฟ ํค ๊ธฐ๋ฐ ๋ธ๋ผ์ฐ์ ์ธ์
์ ์์ํ๊ณ , /admin๊ณผ /api๋ ๋ธ๋ผ์ฐ์ ์ธ์
์ด ํ์ํ๋ฉฐ, /api/v1/quality, /api/v1/maintenance, /tools, /mcp๋ Authorization: Bearer ๋๋ X-API-Key๊ฐ ํ์ํฉ๋๋ค. ์์ธํ ๋ด์ฉ: docs/reference/ko/security.md.
HTTP ์ ์ฉ (MCP์ ์์): restore_anchors, migrate_embeddings, convert_episodic_to_semantic, get_meta_memory_stats โ HTTP ๊ด๋ฆฌ API ์ฐธ์กฐ.
๐ง ํต์ฌ ๋ฉ๋ชจ๋ฆฌ ๊ด๋ฆฌ (MCP ํด๋ผ์ด์ธํธ)
์ฐธ๊ณ : ๋๊ตฌ 22๊ฐ๊ฐ ๋ฑ๋ก๋์ด ์๊ณ ,
tools/list๋ ๊ธฐ๋ณธ 4๊ฐ๋ง ๋ ธ์ถํฉ๋๋ค(MEMENTO_TOOLSET=full๋ก ์ ์ฒด). ์ด์ยท๊ด๋ฆฌ ๊ธฐ๋ฅ์ HTTP API๋ก๋ง ์ ๊ณตํฉ๋๋ค.
๋ฌธ์
- ๋ฌธ์ ํฌํธ: docs/README.md
- ์ค์น: INSTALL.md ยท INSTALL.en.md
- ๊ธฐ์ฌ์ยท์์ด์ ํธ: AGENTS.md ยท CONTRIBUTING.md
- API: docs/api/ko/api-reference.md
- ๋ณด์: docs/reference/ko/security.md
๋ก๋๋งต (์์ฝ)
- M1 ๊ฐ์ธ์ฉ (ํ์ฌ): ๋ก์ปฌ SQLite, MCP + HTTP ๊ด๋ฆฌ API. ์ธ์ฆ: ๋ธ๋ผ์ฐ์ ์ธ์
+ ํค๋ ๊ธฐ๋ฐ ๋ถ๋ฆฌ ์ ๋ขฐ ๋ชจ๋ธ(
/auth/session์ฟ ํค ์ธ์ ,/adminยท/api๋ธ๋ผ์ฐ์ ์ธ์ ์๊ตฌ,/toolsยท/mcp๋ Bearer/API-Key ์๊ตฌ). - M2 ํ (๊ณํ): ๊ณต์ ๋ฐฑ์๋, API Key, Docker
- M3 ์กฐ์ง (๊ณํ): PostgreSQL + pgvector, JWT
๊ธฐ์ฌ ยท ๋ผ์ด์ ์ค ยท ์ง์
๊ธฐ์ฌ๋ CONTRIBUTING.md๋ฅผ ๋ฐ๋ผ ์ฃผ์ธ์. ๋ผ์ด์ ์ค๋ MIT์ ๋๋ค.
- ์ด์: GitHub Issues
- ๋ฌธ์: docs/README.md
Memento MCP questions
How do I add Memento MCP to Claude Code?
Run claude mcp add memento -- npx -y memento-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Memento MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What types of memory does Memento support?
It supports four types of cognitive memory: working, episodic, semantic, and procedural.
How can I see all available tools in the server?
By default, only four tools are exposed. To see the full list of 22 tools, set the environment variable MEMENTO_TOOLSET=full.
Which package manager is supported for installation?
The server only supports npm; pnpm and yarn are not supported.
How is the memory data stored?
The memory database is stored in a file specified by the DB_PATH environment variable, typically a .db file.