mcp-sqlite-memory-bank 1.2.4__tar.gz → 1.3.1__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 (24) hide show
  1. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/PKG-INFO +63 -8
  2. mcp_sqlite_memory_bank-1.2.4/src/mcp_sqlite_memory_bank.egg-info/PKG-INFO → mcp_sqlite_memory_bank-1.3.1/README.md +57 -28
  3. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/pyproject.toml +7 -3
  4. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank/__init__.py +6 -9
  5. mcp_sqlite_memory_bank-1.3.1/src/mcp_sqlite_memory_bank/database.py +1010 -0
  6. mcp_sqlite_memory_bank-1.3.1/src/mcp_sqlite_memory_bank/semantic.py +398 -0
  7. mcp_sqlite_memory_bank-1.3.1/src/mcp_sqlite_memory_bank/server.py +864 -0
  8. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank/types.py +111 -9
  9. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank/utils.py +23 -52
  10. mcp_sqlite_memory_bank-1.2.4/README.md → mcp_sqlite_memory_bank-1.3.1/src/mcp_sqlite_memory_bank.egg-info/PKG-INFO +83 -6
  11. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank.egg-info/SOURCES.txt +2 -0
  12. mcp_sqlite_memory_bank-1.3.1/src/mcp_sqlite_memory_bank.egg-info/requires.txt +11 -0
  13. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/tests/test_api.py +163 -165
  14. mcp_sqlite_memory_bank-1.3.1/tests/test_server.py +179 -0
  15. mcp_sqlite_memory_bank-1.2.4/src/mcp_sqlite_memory_bank/server.py +0 -1140
  16. mcp_sqlite_memory_bank-1.2.4/src/mcp_sqlite_memory_bank.egg-info/requires.txt +0 -7
  17. mcp_sqlite_memory_bank-1.2.4/tests/test_server.py +0 -189
  18. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/LICENSE +0 -0
  19. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/MANIFEST.in +0 -0
  20. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/setup.cfg +0 -0
  21. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank/py.typed +0 -0
  22. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank.egg-info/dependency_links.txt +0 -0
  23. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank.egg-info/entry_points.txt +0 -0
  24. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.1}/src/mcp_sqlite_memory_bank.egg-info/top_level.txt +0 -0
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp_sqlite_memory_bank
3
- Version: 1.2.4
4
- Summary: A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers.
3
+ Version: 1.3.1
4
+ Summary: A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers with semantic search capabilities.
5
5
  Author-email: Robert Meisner <robert@catchit.pl>
6
6
  License-Expression: MIT
7
7
  Project-URL: Homepage, https://github.com/robertmeisner/mcp_sqlite_memory_bank
@@ -16,6 +16,10 @@ Requires-Dist: fastapi>=0.100.0
16
16
  Requires-Dist: uvicorn>=0.22.0
17
17
  Requires-Dist: pydantic>=1.10.0
18
18
  Requires-Dist: fastmcp
19
+ Requires-Dist: sqlalchemy>=2.0.0
20
+ Requires-Dist: sentence-transformers>=2.2.0
21
+ Requires-Dist: torch>=1.9.0
22
+ Requires-Dist: numpy>=1.21.0
19
23
  Provides-Extra: test
20
24
  Requires-Dist: pytest; extra == "test"
21
25
  Dynamic: license-file
@@ -210,17 +214,39 @@ python -m mcp_sqlite_memory_bank.server main --host 127.0.0.1 --port 8000
210
214
 
211
215
  ## Setup and Configuration
212
216
 
213
- You can configure the database path and other options via environment variables or a `.env` file in your project root.
217
+ ### Database Location
218
+
219
+ **Default Behavior (v1.2.5+):**
220
+ - **User-specific database**: `~/.mcp_sqlite_memory/memory.db`
221
+ - **Isolated per user**: Each user gets their own database
222
+ - **Persistent across projects**: Data is preserved between sessions
223
+
224
+ **Custom Database Paths:**
225
+ You can configure a custom database location via the `DB_PATH` environment variable:
226
+
227
+ - **Project-specific**: `DB_PATH=./project_memory.db`
228
+ - **Shared team database**: `DB_PATH=/shared/team_memory.db`
229
+ - **Temporary database**: `DB_PATH=/tmp/session_memory.db`
214
230
 
215
231
  **Environment Variables:**
216
- - `DB_PATH`: Path to the SQLite database file (default: `./test.db`)
217
- - Any other options supported by the server (see API docs)
232
+ - `DB_PATH`: Path to the SQLite database file (default: `~/.mcp_sqlite_memory/memory.db`)
218
233
 
219
234
  **Example `.env`:**
220
235
  ```env
221
- DB_PATH=./test.db
236
+ # Use project-specific database
237
+ DB_PATH=./project_memory.db
238
+
239
+ # Or use a specific location
240
+ DB_PATH=/path/to/my/memory.db
222
241
  ```
223
242
 
243
+ **Migration Note:**
244
+ If you were using v1.2.4 or earlier, your data was stored in `./test.db` in the current working directory. To migrate your data:
245
+
246
+ 1. Locate your old `test.db` file
247
+ 2. Copy it to the new default location: `~/.mcp_sqlite_memory/memory.db`
248
+ 3. Or set `DB_PATH` to point to your existing database
249
+
224
250
  ---
225
251
 
226
252
  ## Integration with Editors & Agent Platforms
@@ -229,16 +255,45 @@ DB_PATH=./test.db
229
255
 
230
256
  #### Manual Configuration
231
257
 
232
- Add or update `.vscode/mcp.json` in your project root:
258
+ **Option 1: Use Default User Database (Recommended)**
233
259
  ```jsonc
234
260
  {
235
261
  "servers": {
236
262
  "SQLite_Memory": {
237
263
  "type": "stdio",
238
264
  "command": "uvx",
265
+ "args": ["--refresh", "mcp-sqlite-memory-bank"]
266
+ }
267
+ }
268
+ }
269
+ ```
270
+
271
+ **Option 2: Project-Specific Database**
272
+ ```jsonc
273
+ {
274
+ "servers": {
275
+ "SQLite_Memory": {
276
+ "type": "stdio",
277
+ "command": "uvx",
239
278
  "args": ["--refresh", "mcp-sqlite-memory-bank"],
240
279
  "env": {
241
- "DB_PATH": "${workspaceFolder}/.vscode/project_memory.sqlite"
280
+ "DB_PATH": "${workspaceFolder}/.mcp_memory.db"
281
+ }
282
+ }
283
+ }
284
+ }
285
+ ```
286
+
287
+ **Option 3: Custom Database Location**
288
+ ```jsonc
289
+ {
290
+ "servers": {
291
+ "SQLite_Memory": {
292
+ "type": "stdio",
293
+ "command": "uvx",
294
+ "args": ["--refresh", "mcp-sqlite-memory-bank"],
295
+ "env": {
296
+ "DB_PATH": "/path/to/your/custom/memory.db"
242
297
  }
243
298
  }
244
299
  }
@@ -1,25 +1,3 @@
1
- Metadata-Version: 2.4
2
- Name: mcp_sqlite_memory_bank
3
- Version: 1.2.4
4
- Summary: A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers.
5
- Author-email: Robert Meisner <robert@catchit.pl>
6
- License-Expression: MIT
7
- Project-URL: Homepage, https://github.com/robertmeisner/mcp_sqlite_memory_bank
8
- Project-URL: Source, https://github.com/robertmeisner/mcp_sqlite_memory_bank
9
- Project-URL: Issues, https://github.com/robertmeisner/mcp_sqlite_memory_bank/issues
10
- Classifier: Programming Language :: Python :: 3
11
- Classifier: Operating System :: OS Independent
12
- Requires-Python: >=3.8
13
- Description-Content-Type: text/markdown
14
- License-File: LICENSE
15
- Requires-Dist: fastapi>=0.100.0
16
- Requires-Dist: uvicorn>=0.22.0
17
- Requires-Dist: pydantic>=1.10.0
18
- Requires-Dist: fastmcp
19
- Provides-Extra: test
20
- Requires-Dist: pytest; extra == "test"
21
- Dynamic: license-file
22
-
23
1
  # mcp_sqlite_memory_bank
24
2
 
25
3
  ![PyPI](https://img.shields.io/pypi/v/mcp_sqlite_memory_bank)
@@ -210,17 +188,39 @@ python -m mcp_sqlite_memory_bank.server main --host 127.0.0.1 --port 8000
210
188
 
211
189
  ## Setup and Configuration
212
190
 
213
- You can configure the database path and other options via environment variables or a `.env` file in your project root.
191
+ ### Database Location
192
+
193
+ **Default Behavior (v1.2.5+):**
194
+ - **User-specific database**: `~/.mcp_sqlite_memory/memory.db`
195
+ - **Isolated per user**: Each user gets their own database
196
+ - **Persistent across projects**: Data is preserved between sessions
197
+
198
+ **Custom Database Paths:**
199
+ You can configure a custom database location via the `DB_PATH` environment variable:
200
+
201
+ - **Project-specific**: `DB_PATH=./project_memory.db`
202
+ - **Shared team database**: `DB_PATH=/shared/team_memory.db`
203
+ - **Temporary database**: `DB_PATH=/tmp/session_memory.db`
214
204
 
215
205
  **Environment Variables:**
216
- - `DB_PATH`: Path to the SQLite database file (default: `./test.db`)
217
- - Any other options supported by the server (see API docs)
206
+ - `DB_PATH`: Path to the SQLite database file (default: `~/.mcp_sqlite_memory/memory.db`)
218
207
 
219
208
  **Example `.env`:**
220
209
  ```env
221
- DB_PATH=./test.db
210
+ # Use project-specific database
211
+ DB_PATH=./project_memory.db
212
+
213
+ # Or use a specific location
214
+ DB_PATH=/path/to/my/memory.db
222
215
  ```
223
216
 
217
+ **Migration Note:**
218
+ If you were using v1.2.4 or earlier, your data was stored in `./test.db` in the current working directory. To migrate your data:
219
+
220
+ 1. Locate your old `test.db` file
221
+ 2. Copy it to the new default location: `~/.mcp_sqlite_memory/memory.db`
222
+ 3. Or set `DB_PATH` to point to your existing database
223
+
224
224
  ---
225
225
 
226
226
  ## Integration with Editors & Agent Platforms
@@ -229,7 +229,36 @@ DB_PATH=./test.db
229
229
 
230
230
  #### Manual Configuration
231
231
 
232
- Add or update `.vscode/mcp.json` in your project root:
232
+ **Option 1: Use Default User Database (Recommended)**
233
+ ```jsonc
234
+ {
235
+ "servers": {
236
+ "SQLite_Memory": {
237
+ "type": "stdio",
238
+ "command": "uvx",
239
+ "args": ["--refresh", "mcp-sqlite-memory-bank"]
240
+ }
241
+ }
242
+ }
243
+ ```
244
+
245
+ **Option 2: Project-Specific Database**
246
+ ```jsonc
247
+ {
248
+ "servers": {
249
+ "SQLite_Memory": {
250
+ "type": "stdio",
251
+ "command": "uvx",
252
+ "args": ["--refresh", "mcp-sqlite-memory-bank"],
253
+ "env": {
254
+ "DB_PATH": "${workspaceFolder}/.mcp_memory.db"
255
+ }
256
+ }
257
+ }
258
+ }
259
+ ```
260
+
261
+ **Option 3: Custom Database Location**
233
262
  ```jsonc
234
263
  {
235
264
  "servers": {
@@ -238,7 +267,7 @@ Add or update `.vscode/mcp.json` in your project root:
238
267
  "command": "uvx",
239
268
  "args": ["--refresh", "mcp-sqlite-memory-bank"],
240
269
  "env": {
241
- "DB_PATH": "${workspaceFolder}/.vscode/project_memory.sqlite"
270
+ "DB_PATH": "/path/to/your/custom/memory.db"
242
271
  }
243
272
  }
244
273
  }
@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "mcp_sqlite_memory_bank"
7
- version = "1.2.4"
8
- description = "A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers."
7
+ version = "1.3.1"
8
+ description = "A dynamic, agent/LLM-friendly SQLite memory bank for MCP servers with semantic search capabilities."
9
9
  authors = [
10
10
  { name="Robert Meisner", email="robert@catchit.pl" }
11
11
  ]
@@ -21,7 +21,11 @@ dependencies = [
21
21
  "fastapi>=0.100.0",
22
22
  "uvicorn>=0.22.0",
23
23
  "pydantic>=1.10.0",
24
- "fastmcp"
24
+ "fastmcp",
25
+ "sqlalchemy>=2.0.0",
26
+ "sentence-transformers>=2.2.0",
27
+ "torch>=1.9.0",
28
+ "numpy>=1.21.0"
25
29
  ]
26
30
 
27
31
  [project.scripts]
@@ -25,10 +25,11 @@ from .server import (
25
25
  update_rows,
26
26
  delete_rows,
27
27
  run_select_query,
28
-
28
+ # Search tools
29
+ search_content,
30
+ explore_tables,
29
31
  # FastMCP app
30
32
  app,
31
-
32
33
  # Constants
33
34
  DB_PATH,
34
35
  )
@@ -49,7 +50,6 @@ from .types import (
49
50
  SelectQueryResponse,
50
51
  ErrorResponse,
51
52
  ToolResponse,
52
-
53
53
  # Error types
54
54
  ValidationError,
55
55
  DatabaseError,
@@ -57,7 +57,6 @@ from .types import (
57
57
  DataError,
58
58
  MemoryBankError,
59
59
  ErrorCategory,
60
-
61
60
  # Data types
62
61
  TableColumn,
63
62
  SqliteType,
@@ -79,13 +78,13 @@ __all__ = [
79
78
  "update_rows",
80
79
  "delete_rows",
81
80
  "run_select_query",
82
-
81
+ # Search tools
82
+ "search_content",
83
+ "explore_tables",
83
84
  # FastMCP app
84
85
  "app",
85
-
86
86
  # Constants
87
87
  "DB_PATH",
88
-
89
88
  # Response types
90
89
  "CreateTableResponse",
91
90
  "DropTableResponse",
@@ -100,7 +99,6 @@ __all__ = [
100
99
  "SelectQueryResponse",
101
100
  "ErrorResponse",
102
101
  "ToolResponse",
103
-
104
102
  # Error types
105
103
  "ValidationError",
106
104
  "DatabaseError",
@@ -108,7 +106,6 @@ __all__ = [
108
106
  "DataError",
109
107
  "MemoryBankError",
110
108
  "ErrorCategory",
111
-
112
109
  # Data types
113
110
  "TableColumn",
114
111
  "SqliteType",