better-mem0-mcp 1.1.0b20__tar.gz → 1.1.0b22__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.github/workflows/cd.yml +42 -5
  2. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.mise.toml +1 -1
  3. better_mem0_mcp-1.1.0b22/.vscode/better-mem0-mcp.code-workspace +23 -0
  4. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/CHANGELOG.md +14 -0
  5. better_mem0_mcp-1.1.0b22/CODE_OF_CONDUCT.md +82 -0
  6. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/CONTRIBUTING.md +49 -0
  7. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/PKG-INFO +58 -34
  8. better_mem0_mcp-1.1.0b22/README.md +144 -0
  9. better_mem0_mcp-1.1.0b22/SECURITY.md +32 -0
  10. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/pyproject.toml +2 -2
  11. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/src/better_mem0_mcp/config.py +14 -21
  12. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/uv.lock +4 -505
  13. better_mem0_mcp-1.1.0b20/.vscode/better-mem0-mcp.code-workspace +0 -8
  14. better_mem0_mcp-1.1.0b20/README.md +0 -120
  15. better_mem0_mcp-1.1.0b20/SECURITY.md +0 -27
  16. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.dockerignore +0 -0
  17. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.editorconfig +0 -0
  18. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.github/scripts/check-ci-cd-status.sh +0 -0
  19. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.github/scripts/merge-with-auto-resolve.sh +0 -0
  20. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.github/workflows/ci.yml +0 -0
  21. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.gitignore +0 -0
  22. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.pre-commit-config.yaml +0 -0
  23. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.python-version +0 -0
  24. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/.releaserc.json +0 -0
  25. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/Dockerfile +0 -0
  26. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/LICENSE +0 -0
  27. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/package-lock.json +0 -0
  28. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/package.json +0 -0
  29. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/scripts/clean-venv.mjs +0 -0
  30. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/src/better_mem0_mcp/__init__.py +0 -0
  31. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/src/better_mem0_mcp/__main__.py +0 -0
  32. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/src/better_mem0_mcp/docs/memory.md +0 -0
  33. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/src/better_mem0_mcp/graph.py +0 -0
  34. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/src/better_mem0_mcp/py.typed +0 -0
  35. {better_mem0_mcp-1.1.0b20 → better_mem0_mcp-1.1.0b22}/src/better_mem0_mcp/server.py +0 -0
@@ -46,12 +46,49 @@ jobs:
46
46
  chmod +x .github/scripts/check-ci-cd-status.sh
47
47
  ./.github/scripts/check-ci-cd-status.sh --branch=dev
48
48
 
49
- - name: Merge dev to main
49
+ - name: Sync main into dev (resolve version conflicts)
50
+ run: |
51
+ git config user.name "github-actions[bot]"
52
+ git config user.email "github-actions[bot]@users.noreply.github.com"
53
+ git checkout dev
54
+ git fetch origin main
55
+ git merge origin/main --no-edit -X ours || true
56
+ git push origin dev
57
+
58
+ - name: Create PR to promote dev to main
50
59
  env:
51
- AUTO_RESOLVE_FILES: "CHANGELOG.md,pyproject.toml"
60
+ GH_TOKEN: ${{ secrets.GH_PAT }}
52
61
  run: |
53
- chmod +x .github/scripts/merge-with-auto-resolve.sh
54
- ./.github/scripts/merge-with-auto-resolve.sh --source=dev --target=main --files="$AUTO_RESOLVE_FILES"
62
+ # Check if PR already exists
63
+ EXISTING_PR=$(gh pr list --base main --head dev --json number --jq '.[0].number')
64
+ if [ -n "$EXISTING_PR" ]; then
65
+ echo "PR #$EXISTING_PR already exists for dev -> main"
66
+ echo "URL: https://github.com/${{ github.repository }}/pull/$EXISTING_PR"
67
+ exit 0
68
+ fi
69
+
70
+ # Get latest release version from dev
71
+ LATEST_TAG=$(git describe --tags --abbrev=0 origin/dev 2>/dev/null || echo "")
72
+ if [ -z "$LATEST_TAG" ]; then
73
+ PR_TITLE="chore: promote dev to main"
74
+ else
75
+ PR_TITLE="chore: promote dev to main ($LATEST_TAG)"
76
+ fi
77
+
78
+ # Create PR
79
+ gh pr create \
80
+ --base main \
81
+ --head dev \
82
+ --title "$PR_TITLE" \
83
+ --body "## Promote dev to main
84
+
85
+ This PR promotes the latest changes from \`dev\` branch to \`main\`.
86
+
87
+ ### Pre-checks passed:
88
+ - ✅ CI workflow passed on dev
89
+ - ✅ CD workflow passed on dev
90
+
91
+ ### Latest beta version: $LATEST_TAG"
55
92
 
56
93
  release:
57
94
  name: Semantic Release
@@ -71,7 +108,7 @@ jobs:
71
108
  - name: Setup Node.js
72
109
  uses: actions/setup-node@v6
73
110
  with:
74
- node-version: "22"
111
+ node-version: "24"
75
112
 
76
113
  - name: Install uv (for toml-cli)
77
114
  uses: astral-sh/setup-uv@v5
@@ -5,7 +5,7 @@
5
5
 
6
6
  [tools]
7
7
  python = "3.13"
8
- node = "22"
8
+ node = "24"
9
9
  uv = "latest"
10
10
 
11
11
  [settings]
@@ -0,0 +1,23 @@
1
+ {
2
+ "folders": [
3
+ {
4
+ "path": ".."
5
+ },
6
+ {
7
+ "path": "../../EchoVault"
8
+ },
9
+ {
10
+ "path": "../../wet-mcp"
11
+ },
12
+ {
13
+ "path": "../../better-notion-mcp"
14
+ },
15
+ {
16
+ "path": "../../KnowledgePrism"
17
+ },
18
+ {
19
+ "path": "../../QuikShipping"
20
+ }
21
+ ],
22
+ "settings": {}
23
+ }
@@ -1,3 +1,17 @@
1
+ # [1.1.0-beta.22](https://github.com/n24q02m/better-mem0-mcp/compare/v1.1.0-beta.21...v1.1.0-beta.22) (2026-02-05)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * Pin Python version to 3.13 and remove Python 3.14 compatibility from the dependency lock file. ([ec134ef](https://github.com/n24q02m/better-mem0-mcp/commit/ec134ef10ab6de3eaf800d51a441fe2b44f2d4dc))
7
+
8
+ # [1.1.0-beta.21](https://github.com/n24q02m/better-mem0-mcp/compare/v1.1.0-beta.20...v1.1.0-beta.21) (2026-01-12)
9
+
10
+
11
+ ### Bug Fixes
12
+
13
+ * update Node.js version to 24 in CI/CD configuration and Mise setup ([92ab0a9](https://github.com/n24q02m/better-mem0-mcp/commit/92ab0a96cd30643b9ecf927c68b46cde6472d732))
14
+
1
15
  # [1.1.0-beta.20](https://github.com/n24q02m/better-mem0-mcp/compare/v1.1.0-beta.19...v1.1.0-beta.20) (2026-01-05)
2
16
 
3
17
 
@@ -0,0 +1,82 @@
1
+ # Contributor Covenant Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
6
+
7
+ We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
8
+
9
+ ## Our Standards
10
+
11
+ Examples of behavior that contributes to a positive environment for our community include:
12
+
13
+ - Demonstrating empathy and kindness toward other people
14
+ - Being respectful of differing opinions, viewpoints, and experiences
15
+ - Giving and gracefully accepting constructive feedback
16
+ - Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
17
+ - Focusing on what is best not just for us as individuals, but for the overall community
18
+
19
+ Examples of unacceptable behavior include:
20
+
21
+ - The use of sexualized language or imagery, and sexual attention or advances of any kind
22
+ - Trolling, insulting or derogatory comments, and personal or political attacks
23
+ - Public or private harassment
24
+ - Publishing others' private information, such as a physical or email address, without their explicit permission
25
+ - Other conduct which could reasonably be considered inappropriate in a professional setting
26
+
27
+ ## Enforcement Responsibilities
28
+
29
+ Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
30
+
31
+ Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
32
+
33
+ ## Scope
34
+
35
+ This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
36
+
37
+ ## Enforcement
38
+
39
+ Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at quangminh2402.dev@gmail.com. All complaints will be reviewed and investigated promptly and fairly.
40
+
41
+ All community leaders are obligated to respect the privacy and security of the reporter of any incident.
42
+
43
+ ## Enforcement Guidelines
44
+
45
+ Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
46
+
47
+ ### 1. Correction
48
+
49
+ **Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
50
+
51
+ **Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
52
+
53
+ ### 2. Warning
54
+
55
+ **Community Impact**: A violation through a single incident or series of actions.
56
+
57
+ **Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
58
+
59
+ ### 3. Temporary Ban
60
+
61
+ **Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
62
+
63
+ **Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
64
+
65
+ ### 4. Permanent Ban
66
+
67
+ **Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
68
+
69
+ **Consequence**: A permanent ban from any sort of public interaction within the community.
70
+
71
+ ## Attribution
72
+
73
+ This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.0,
74
+ available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
75
+
76
+ Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
77
+
78
+ [homepage]: https://www.contributor-covenant.org
79
+
80
+ For answers to common questions about this code of conduct, see the FAQ at
81
+ https://www.contributor-covenant.org/faq. Translations are available at
82
+ https://www.contributor-covenant.org/translations.
@@ -84,6 +84,8 @@ We use [Conventional Commits](https://www.conventionalcommits.org/):
84
84
  - `perf`: Performance improvements
85
85
  - `test`: Adding or updating tests
86
86
  - `chore`: Maintenance tasks
87
+ - `ci`: CI/CD changes
88
+ - `build`: Build system changes
87
89
 
88
90
  ### Examples
89
91
 
@@ -93,6 +95,44 @@ fix: handle database connection timeout
93
95
  docs: update configuration examples
94
96
  ```
95
97
 
98
+ ## Release Process
99
+
100
+ Releases are automated using **Semantic Release**. We strictly follow the **Conventional Commits** specification to determine version bumps and generate changelogs automatically.
101
+
102
+ ### How to Release
103
+
104
+ 1. Create a Pull Request with your changes.
105
+ 2. Ensure your commit messages follow the convention above.
106
+ 3. Merge the PR to `main`.
107
+ 4. The CI pipeline will automatically:
108
+ - Analyze the new commits
109
+ - Determine the next version number
110
+ - Generate release notes
111
+ - Update `CHANGELOG.md`
112
+ - Publish to PyPI
113
+ - Create a GitHub Release
114
+ - Build and push Docker images
115
+
116
+ You do **not** need to create manual tags or changelog entries.
117
+
118
+ ## Pull Request Guidelines
119
+
120
+ - Keep PRs focused on a single feature or fix
121
+ - Update documentation if needed
122
+ - Add tests for new functionality
123
+ - Ensure all checks pass
124
+
125
+ ### PR Checklist
126
+
127
+ Before submitting your PR, ensure:
128
+
129
+ - [ ] Code follows Python best practices
130
+ - [ ] All tests pass (`uv run pytest`)
131
+ - [ ] Linting passes (`uv run ruff check .`)
132
+ - [ ] Formatting is correct (`uv run ruff format --check .`)
133
+ - [ ] Commit messages follow **Conventional Commits**
134
+ - [ ] Documentation updated (if needed)
135
+
96
136
  ## Code Style
97
137
 
98
138
  This project uses **Ruff** for formatting and linting.
@@ -126,6 +166,15 @@ better-mem0-mcp/
126
166
  └── README.md
127
167
  ```
128
168
 
169
+ ## Questions?
170
+
171
+ Feel free to open an issue for:
172
+
173
+ - Bug reports
174
+ - Feature requests
175
+ - Questions about the codebase
176
+ - Discussion about architecture
177
+
129
178
  ## License
130
179
 
131
180
  By contributing, you agree that your contributions will be licensed under the MIT License.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: better-mem0-mcp
3
- Version: 1.1.0b20
3
+ Version: 1.1.0b22
4
4
  Summary: Zero-setup MCP Server for AI memory - works with Neon/Supabase
5
5
  Project-URL: Homepage, https://github.com/n24q02m/better-mem0-mcp
6
6
  Project-URL: Repository, https://github.com/n24q02m/better-mem0-mcp.git
@@ -17,7 +17,7 @@ Classifier: Operating System :: OS Independent
17
17
  Classifier: Programming Language :: Python :: 3
18
18
  Classifier: Programming Language :: Python :: 3.13
19
19
  Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
- Requires-Python: >=3.13
20
+ Requires-Python: ==3.13.*
21
21
  Requires-Dist: google-genai>=1.0.0
22
22
  Requires-Dist: litellm>=1.0.0
23
23
  Requires-Dist: loguru>=0.7.0
@@ -29,16 +29,28 @@ Description-Content-Type: text/markdown
29
29
 
30
30
  # better-mem0-mcp
31
31
 
32
- **Zero-setup** MCP Server for AI memory. Works with Neon/Supabase free tier.
32
+ **Self-hosted MCP Server for AI memory with PostgreSQL (pgvector).**
33
33
 
34
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
34
+ [![PyPI](https://img.shields.io/pypi/v/better-mem0-mcp)](https://pypi.org/project/better-mem0-mcp/)
35
+ [![Docker](https://img.shields.io/docker/v/n24q02m/better-mem0-mcp?label=docker)](https://hub.docker.com/r/n24q02m/better-mem0-mcp)
36
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
37
+
38
+ ## Features
39
+
40
+ - **Self-hosted PostgreSQL** - Your data stays with you (Neon/Supabase free tier supported)
41
+ - **Graph Memory** - SQL-based relationship tracking alongside vector memory
42
+ - **Multi-provider LLM** - Gemini, OpenAI, Anthropic, Groq, DeepSeek, Mistral
43
+ - **Fallback chains** - Multi-key per provider + multi-model fallback
44
+ - **Zero manual setup** - Just `DATABASE_URL` + `API_KEYS`
45
+
46
+ ---
35
47
 
36
48
  ## Quick Start
37
49
 
38
50
  ### 1. Get Prerequisites
39
51
 
40
- - **Database**: [Neon](https://neon.tech) or [Supabase](https://supabase.com) (free tier)
41
- - **API Key**: [Google AI Studio](https://aistudio.google.com/apikey) (free tier)
52
+ - **Database**: [Neon](https://neon.tech) or [Supabase](https://supabase.com) (free tier works)
53
+ - **API Key**: Any supported provider ([Google AI Studio](https://aistudio.google.com/apikey) is free)
42
54
 
43
55
  ### 2. Add to mcp.json
44
56
 
@@ -52,7 +64,7 @@ Description-Content-Type: text/markdown
52
64
  "args": ["better-mem0-mcp@latest"],
53
65
  "env": {
54
66
  "DATABASE_URL": "postgresql://user:pass@xxx.neon.tech/neondb?sslmode=require",
55
- "API_KEYS": "gemini:AIza..."
67
+ "API_KEYS": "GOOGLE_API_KEY:AIza..."
56
68
  }
57
69
  }
58
70
  }
@@ -69,7 +81,7 @@ Description-Content-Type: text/markdown
69
81
  "args": ["run", "-i", "--rm", "-e", "DATABASE_URL", "-e", "API_KEYS", "n24q02m/better-mem0-mcp:latest"],
70
82
  "env": {
71
83
  "DATABASE_URL": "postgresql://...",
72
- "API_KEYS": "gemini:AIza..."
84
+ "API_KEYS": "GOOGLE_API_KEY:AIza..."
73
85
  }
74
86
  }
75
87
  }
@@ -78,7 +90,7 @@ Description-Content-Type: text/markdown
78
90
 
79
91
  ### 3. Done!
80
92
 
81
- Ask Claude: "Remember that I prefer dark mode and use FastAPI"
93
+ Ask your AI: "Remember that I prefer dark mode and use FastAPI"
82
94
 
83
95
  ---
84
96
 
@@ -86,22 +98,25 @@ Ask Claude: "Remember that I prefer dark mode and use FastAPI"
86
98
 
87
99
  | Variable | Required | Description |
88
100
  |----------|----------|-------------|
89
- | `DATABASE_URL` | Yes | PostgreSQL connection string |
90
- | `API_KEYS` | Yes | `provider:key,...` (multi-key per provider OK) |
91
- | `LLM_MODELS` | No | `provider/model,...` (fallback chain) |
92
- | `EMBEDDER_MODELS` | No | `provider/model,...` (fallback chain) |
101
+ | `DATABASE_URL` | Yes | PostgreSQL with pgvector extension |
102
+ | `API_KEYS` | Yes | `ENV_VAR:key` pairs, comma-separated |
103
+ | `LLM_MODELS` | No | Model fallback chain |
104
+ | `EMBEDDER_MODELS` | No | Embedding model chain |
93
105
 
94
- ### Examples
106
+ ### Supported LiteLLM Providers
95
107
 
96
- **Minimal (Gemini only):**
97
- ```
98
- API_KEYS=gemini:AIza...
108
+ Use environment variable names from [LiteLLM docs](https://docs.litellm.ai/):
109
+ `GOOGLE_API_KEY`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GROQ_API_KEY`, etc.
110
+
111
+ **Single provider:**
112
+ ```bash
113
+ API_KEYS=GOOGLE_API_KEY:AIza...
99
114
  ```
100
115
 
101
116
  **Multi-key with fallback:**
102
- ```
103
- API_KEYS=gemini:AIza-1,gemini:AIza-2,openai:sk-xxx
104
- LLM_MODELS=gemini/gemini-2.5-flash,openai/gpt-4o-mini
117
+ ```bash
118
+ API_KEYS=GOOGLE_API_KEY:AIza-1,GOOGLE_API_KEY:AIza-2,OPENAI_API_KEY:sk-xxx
119
+ LLM_MODELS=gemini/gemini-3-flash-preview,openai/gpt-4o-mini
105
120
  EMBEDDER_MODELS=gemini/gemini-embedding-001,openai/text-embedding-3-small
106
121
  ```
107
122
 
@@ -109,7 +124,7 @@ EMBEDDER_MODELS=gemini/gemini-embedding-001,openai/text-embedding-3-small
109
124
 
110
125
  | Setting | Default |
111
126
  |---------|---------|
112
- | `LLM_MODELS` | `gemini/gemini-2.5-flash` |
127
+ | `LLM_MODELS` | `gemini/gemini-3-flash-preview` |
113
128
  | `EMBEDDER_MODELS` | `gemini/gemini-embedding-001` |
114
129
 
115
130
  ---
@@ -118,32 +133,41 @@ EMBEDDER_MODELS=gemini/gemini-embedding-001,openai/text-embedding-3-small
118
133
 
119
134
  | Tool | Description |
120
135
  |------|-------------|
121
- | `memory` | `action`: add, search, list, delete |
122
- | `help` | Detailed documentation |
136
+ | `memory` | Memory operations: `add`, `search`, `list`, `delete` |
137
+ | `help` | Get full documentation for tools |
123
138
 
124
- ### Usage
139
+ ### Usage Examples
125
140
 
126
141
  ```json
127
142
  {"action": "add", "content": "I prefer TypeScript over JavaScript"}
128
- {"action": "search", "query": "preferences"}
143
+ {"action": "search", "query": "programming preferences"}
129
144
  {"action": "list"}
130
145
  {"action": "delete", "memory_id": "abc123"}
131
146
  ```
132
147
 
133
148
  ---
134
149
 
135
- ## Why better-mem0-mcp?
150
+ ## Build from Source
136
151
 
137
- | Feature | Official mem0-mcp | better-mem0-mcp |
138
- |---------|-------------------|-----------------|
139
- | Storage | Mem0 Cloud | **Self-hosted PostgreSQL** |
140
- | Graph Memory | No | **Yes (SQL-based)** |
141
- | LLM Provider | OpenAI only | **Any (Gemini/OpenAI/Ollama/...)** |
142
- | Fallback | No | **Yes (multi-key + multi-model)** |
143
- | Setup | API Key | **DATABASE_URL + API_KEYS** |
152
+ ```bash
153
+ git clone https://github.com/n24q02m/better-mem0-mcp
154
+ cd better-mem0-mcp
155
+
156
+ # Setup (requires mise: https://mise.jdx.dev/)
157
+ mise run setup
158
+
159
+ # Run
160
+ uv run better-mem0-mcp
161
+ ```
162
+
163
+ **Requirements:** Python 3.13+
144
164
 
145
165
  ---
146
166
 
167
+ ## Contributing
168
+
169
+ See [CONTRIBUTING.md](CONTRIBUTING.md)
170
+
147
171
  ## License
148
172
 
149
- MIT
173
+ MIT - See [LICENSE](LICENSE)
@@ -0,0 +1,144 @@
1
+ # better-mem0-mcp
2
+
3
+ **Self-hosted MCP Server for AI memory with PostgreSQL (pgvector).**
4
+
5
+ [![PyPI](https://img.shields.io/pypi/v/better-mem0-mcp)](https://pypi.org/project/better-mem0-mcp/)
6
+ [![Docker](https://img.shields.io/docker/v/n24q02m/better-mem0-mcp?label=docker)](https://hub.docker.com/r/n24q02m/better-mem0-mcp)
7
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
8
+
9
+ ## Features
10
+
11
+ - **Self-hosted PostgreSQL** - Your data stays with you (Neon/Supabase free tier supported)
12
+ - **Graph Memory** - SQL-based relationship tracking alongside vector memory
13
+ - **Multi-provider LLM** - Gemini, OpenAI, Anthropic, Groq, DeepSeek, Mistral
14
+ - **Fallback chains** - Multi-key per provider + multi-model fallback
15
+ - **Zero manual setup** - Just `DATABASE_URL` + `API_KEYS`
16
+
17
+ ---
18
+
19
+ ## Quick Start
20
+
21
+ ### 1. Get Prerequisites
22
+
23
+ - **Database**: [Neon](https://neon.tech) or [Supabase](https://supabase.com) (free tier works)
24
+ - **API Key**: Any supported provider ([Google AI Studio](https://aistudio.google.com/apikey) is free)
25
+
26
+ ### 2. Add to mcp.json
27
+
28
+ #### uvx (Recommended)
29
+
30
+ ```json
31
+ {
32
+ "mcpServers": {
33
+ "better-mem0": {
34
+ "command": "uvx",
35
+ "args": ["better-mem0-mcp@latest"],
36
+ "env": {
37
+ "DATABASE_URL": "postgresql://user:pass@xxx.neon.tech/neondb?sslmode=require",
38
+ "API_KEYS": "GOOGLE_API_KEY:AIza..."
39
+ }
40
+ }
41
+ }
42
+ }
43
+ ```
44
+
45
+ #### Docker
46
+
47
+ ```json
48
+ {
49
+ "mcpServers": {
50
+ "better-mem0": {
51
+ "command": "docker",
52
+ "args": ["run", "-i", "--rm", "-e", "DATABASE_URL", "-e", "API_KEYS", "n24q02m/better-mem0-mcp:latest"],
53
+ "env": {
54
+ "DATABASE_URL": "postgresql://...",
55
+ "API_KEYS": "GOOGLE_API_KEY:AIza..."
56
+ }
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ ### 3. Done!
63
+
64
+ Ask your AI: "Remember that I prefer dark mode and use FastAPI"
65
+
66
+ ---
67
+
68
+ ## Configuration
69
+
70
+ | Variable | Required | Description |
71
+ |----------|----------|-------------|
72
+ | `DATABASE_URL` | Yes | PostgreSQL with pgvector extension |
73
+ | `API_KEYS` | Yes | `ENV_VAR:key` pairs, comma-separated |
74
+ | `LLM_MODELS` | No | Model fallback chain |
75
+ | `EMBEDDER_MODELS` | No | Embedding model chain |
76
+
77
+ ### Supported LiteLLM Providers
78
+
79
+ Use environment variable names from [LiteLLM docs](https://docs.litellm.ai/):
80
+ `GOOGLE_API_KEY`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GROQ_API_KEY`, etc.
81
+
82
+ **Single provider:**
83
+ ```bash
84
+ API_KEYS=GOOGLE_API_KEY:AIza...
85
+ ```
86
+
87
+ **Multi-key with fallback:**
88
+ ```bash
89
+ API_KEYS=GOOGLE_API_KEY:AIza-1,GOOGLE_API_KEY:AIza-2,OPENAI_API_KEY:sk-xxx
90
+ LLM_MODELS=gemini/gemini-3-flash-preview,openai/gpt-4o-mini
91
+ EMBEDDER_MODELS=gemini/gemini-embedding-001,openai/text-embedding-3-small
92
+ ```
93
+
94
+ ### Defaults
95
+
96
+ | Setting | Default |
97
+ |---------|---------|
98
+ | `LLM_MODELS` | `gemini/gemini-3-flash-preview` |
99
+ | `EMBEDDER_MODELS` | `gemini/gemini-embedding-001` |
100
+
101
+ ---
102
+
103
+ ## Tools
104
+
105
+ | Tool | Description |
106
+ |------|-------------|
107
+ | `memory` | Memory operations: `add`, `search`, `list`, `delete` |
108
+ | `help` | Get full documentation for tools |
109
+
110
+ ### Usage Examples
111
+
112
+ ```json
113
+ {"action": "add", "content": "I prefer TypeScript over JavaScript"}
114
+ {"action": "search", "query": "programming preferences"}
115
+ {"action": "list"}
116
+ {"action": "delete", "memory_id": "abc123"}
117
+ ```
118
+
119
+ ---
120
+
121
+ ## Build from Source
122
+
123
+ ```bash
124
+ git clone https://github.com/n24q02m/better-mem0-mcp
125
+ cd better-mem0-mcp
126
+
127
+ # Setup (requires mise: https://mise.jdx.dev/)
128
+ mise run setup
129
+
130
+ # Run
131
+ uv run better-mem0-mcp
132
+ ```
133
+
134
+ **Requirements:** Python 3.13+
135
+
136
+ ---
137
+
138
+ ## Contributing
139
+
140
+ See [CONTRIBUTING.md](CONTRIBUTING.md)
141
+
142
+ ## License
143
+
144
+ MIT - See [LICENSE](LICENSE)
@@ -0,0 +1,32 @@
1
+ # Security Policy
2
+
3
+ ## Supported Versions
4
+
5
+ | Version | Supported |
6
+ | ------- | ------------------ |
7
+ | 1.x.x | :white_check_mark: |
8
+ | < 1.0 | :x: |
9
+
10
+ ## Reporting a Vulnerability
11
+
12
+ If you discover a security vulnerability, please **DO NOT** create a public issue.
13
+
14
+ Instead, please email: **quangminh2402.dev@gmail.com**
15
+
16
+ Include:
17
+
18
+ 1. Detailed description of the vulnerability
19
+ 2. Steps to reproduce
20
+ 3. Potential impact
21
+ 4. Suggested fix (if any)
22
+
23
+ You will receive acknowledgment within 48 hours.
24
+
25
+ ## Security Best Practices
26
+
27
+ When using better-mem0-mcp:
28
+
29
+ - **Never commit API keys** to version control
30
+ - Use environment variables or secure secret management
31
+ - Keep dependencies updated
32
+ - Use `sslmode=require` for production database connections
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "better-mem0-mcp"
3
- version = "1.1.0-beta.20"
3
+ version = "1.1.0-beta.22"
4
4
  description = "Zero-setup MCP Server for AI memory - works with Neon/Supabase"
5
5
  readme = "README.md"
6
6
  license = { text = "MIT" }
@@ -16,7 +16,7 @@ classifiers = [
16
16
  "Programming Language :: Python :: 3.13",
17
17
  "Topic :: Scientific/Engineering :: Artificial Intelligence",
18
18
  ]
19
- requires-python = ">=3.13"
19
+ requires-python = "==3.13.*"
20
20
  dependencies = [
21
21
  # MCP Server
22
22
  "mcp[cli]>=1.0.0",