Adam Framework MCP Server
Exposes Adam's persistent vault memory as MCP tools, usable in Claude Desktop, Cursor, Windsurf, or any MCP-compatible client.
Tools
| Tool | Description |
|---|---|
memory_search |
Search vault markdown files by keyword — returns excerpts with file names and line numbers |
memory_get |
Retrieve the full contents of a specific vault file by name |
memory_list |
List all memory files available in the vault |
Quick Start
Claude Desktop (stdio)
Add to your claude_desktop_config.json:
{
"mcpServers": {
"adam-memory": {
"command": "python",
"args": ["C:/path/to/mcp-server/server.py"],
"env": {
"ADAM_VAULT_PATH": "C:/path/to/your/vault"
}
}
}
}
Docker
docker build -t adam-mcp .
docker run -e ADAM_VAULT_PATH=/vault -v C:/path/to/your/vault:/vault adam-mcp
Install dependencies
pip install mcp
Environment Variables
| Variable | Default | Description |
|---|---|---|
ADAM_VAULT_PATH |
~/vault |
Path to your Adam vault workspace directory |
About
The Adam Framework is a 5-layer persistent memory and identity architecture for local AI agents. The memory lives in plain markdown files you own. The model is just the reader.
1 maintainer
Release files for adam-mcp 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| adam_mcp-1.0.1.tar.gz | 3.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| adam_mcp-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.8 kB
Release files / adam_mcp-1.0.1.tar.gz
| Download URL | adam_mcp-1.0.1.tar.gz |
|---|---|
| Size | 3.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
99d625d85e2fdde3f3f0b0ae995520eb5b925f788ae4fae6026b9400d63d9616
|
|
BLAKE2b-256 checksum How to use checksums |
12f51a03ff54cdf3a268d0d58320633d83a68fb94465669b145beb0ebb746f01
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|
Release files / adam_mcp-1.0.1-py3-none-any.whl
| Download URL | adam_mcp-1.0.1-py3-none-any.whl |
|---|---|
| Size | 4.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe280914f3bb33113d22ec9a4393150d25f6baa2c25f5d3140208aea9985a08e
|
|
BLAKE2b-256 checksum How to use checksums |
cf87f7c239c9c808e314865486ed02bce69a961e4d46f21a954be6b3f79fe9da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|
