mcp-sqlite-memory-bank 1.2.4__tar.gz → 1.3.0__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 (23) hide show
  1. {mcp_sqlite_memory_bank-1.2.4/src/mcp_sqlite_memory_bank.egg-info → mcp_sqlite_memory_bank-1.3.0}/PKG-INFO +59 -8
  2. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/README.md +57 -6
  3. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/pyproject.toml +2 -2
  4. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank/__init__.py +6 -9
  5. mcp_sqlite_memory_bank-1.3.0/src/mcp_sqlite_memory_bank/database.py +923 -0
  6. mcp_sqlite_memory_bank-1.3.0/src/mcp_sqlite_memory_bank/semantic.py +386 -0
  7. mcp_sqlite_memory_bank-1.3.0/src/mcp_sqlite_memory_bank/server.py +838 -0
  8. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank/types.py +105 -9
  9. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank/utils.py +22 -54
  10. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0/src/mcp_sqlite_memory_bank.egg-info}/PKG-INFO +59 -8
  11. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank.egg-info/SOURCES.txt +2 -0
  12. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/tests/test_api.py +163 -165
  13. mcp_sqlite_memory_bank-1.3.0/tests/test_server.py +179 -0
  14. mcp_sqlite_memory_bank-1.2.4/src/mcp_sqlite_memory_bank/server.py +0 -1140
  15. mcp_sqlite_memory_bank-1.2.4/tests/test_server.py +0 -189
  16. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/LICENSE +0 -0
  17. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/MANIFEST.in +0 -0
  18. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/setup.cfg +0 -0
  19. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank/py.typed +0 -0
  20. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank.egg-info/dependency_links.txt +0 -0
  21. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank.egg-info/entry_points.txt +0 -0
  22. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/src/mcp_sqlite_memory_bank.egg-info/requires.txt +0 -0
  23. {mcp_sqlite_memory_bank-1.2.4 → mcp_sqlite_memory_bank-1.3.0}/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.0
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
@@ -210,17 +210,39 @@ python -m mcp_sqlite_memory_bank.server main --host 127.0.0.1 --port 8000
210
210
 
211
211
  ## Setup and Configuration
212
212
 
213
- You can configure the database path and other options via environment variables or a `.env` file in your project root.
213
+ ### Database Location
214
+
215
+ **Default Behavior (v1.2.5+):**
216
+ - **User-specific database**: `~/.mcp_sqlite_memory/memory.db`
217
+ - **Isolated per user**: Each user gets their own database
218
+ - **Persistent across projects**: Data is preserved between sessions
219
+
220
+ **Custom Database Paths:**
221
+ You can configure a custom database location via the `DB_PATH` environment variable:
222
+
223
+ - **Project-specific**: `DB_PATH=./project_memory.db`
224
+ - **Shared team database**: `DB_PATH=/shared/team_memory.db`
225
+ - **Temporary database**: `DB_PATH=/tmp/session_memory.db`
214
226
 
215
227
  **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)
228
+ - `DB_PATH`: Path to the SQLite database file (default: `~/.mcp_sqlite_memory/memory.db`)
218
229
 
219
230
  **Example `.env`:**
220
231
  ```env
221
- DB_PATH=./test.db
232
+ # Use project-specific database
233
+ DB_PATH=./project_memory.db
234
+
235
+ # Or use a specific location
236
+ DB_PATH=/path/to/my/memory.db
222
237
  ```
223
238
 
239
+ **Migration Note:**
240
+ 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:
241
+
242
+ 1. Locate your old `test.db` file
243
+ 2. Copy it to the new default location: `~/.mcp_sqlite_memory/memory.db`
244
+ 3. Or set `DB_PATH` to point to your existing database
245
+
224
246
  ---
225
247
 
226
248
  ## Integration with Editors & Agent Platforms
@@ -229,16 +251,45 @@ DB_PATH=./test.db
229
251
 
230
252
  #### Manual Configuration
231
253
 
232
- Add or update `.vscode/mcp.json` in your project root:
254
+ **Option 1: Use Default User Database (Recommended)**
233
255
  ```jsonc
234
256
  {
235
257
  "servers": {
236
258
  "SQLite_Memory": {
237
259
  "type": "stdio",
238
260
  "command": "uvx",
261
+ "args": ["--refresh", "mcp-sqlite-memory-bank"]
262
+ }
263
+ }
264
+ }
265
+ ```
266
+
267
+ **Option 2: Project-Specific Database**
268
+ ```jsonc
269
+ {
270
+ "servers": {
271
+ "SQLite_Memory": {
272
+ "type": "stdio",
273
+ "command": "uvx",
239
274
  "args": ["--refresh", "mcp-sqlite-memory-bank"],
240
275
  "env": {
241
- "DB_PATH": "${workspaceFolder}/.vscode/project_memory.sqlite"
276
+ "DB_PATH": "${workspaceFolder}/.mcp_memory.db"
277
+ }
278
+ }
279
+ }
280
+ }
281
+ ```
282
+
283
+ **Option 3: Custom Database Location**
284
+ ```jsonc
285
+ {
286
+ "servers": {
287
+ "SQLite_Memory": {
288
+ "type": "stdio",
289
+ "command": "uvx",
290
+ "args": ["--refresh", "mcp-sqlite-memory-bank"],
291
+ "env": {
292
+ "DB_PATH": "/path/to/your/custom/memory.db"
242
293
  }
243
294
  }
244
295
  }
@@ -188,17 +188,39 @@ python -m mcp_sqlite_memory_bank.server main --host 127.0.0.1 --port 8000
188
188
 
189
189
  ## Setup and Configuration
190
190
 
191
- 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`
192
204
 
193
205
  **Environment Variables:**
194
- - `DB_PATH`: Path to the SQLite database file (default: `./test.db`)
195
- - 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`)
196
207
 
197
208
  **Example `.env`:**
198
209
  ```env
199
- 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
200
215
  ```
201
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
+
202
224
  ---
203
225
 
204
226
  ## Integration with Editors & Agent Platforms
@@ -207,16 +229,45 @@ DB_PATH=./test.db
207
229
 
208
230
  #### Manual Configuration
209
231
 
210
- Add or update `.vscode/mcp.json` in your project root:
232
+ **Option 1: Use Default User Database (Recommended)**
211
233
  ```jsonc
212
234
  {
213
235
  "servers": {
214
236
  "SQLite_Memory": {
215
237
  "type": "stdio",
216
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",
217
252
  "args": ["--refresh", "mcp-sqlite-memory-bank"],
218
253
  "env": {
219
- "DB_PATH": "${workspaceFolder}/.vscode/project_memory.sqlite"
254
+ "DB_PATH": "${workspaceFolder}/.mcp_memory.db"
255
+ }
256
+ }
257
+ }
258
+ }
259
+ ```
260
+
261
+ **Option 3: Custom Database Location**
262
+ ```jsonc
263
+ {
264
+ "servers": {
265
+ "SQLite_Memory": {
266
+ "type": "stdio",
267
+ "command": "uvx",
268
+ "args": ["--refresh", "mcp-sqlite-memory-bank"],
269
+ "env": {
270
+ "DB_PATH": "/path/to/your/custom/memory.db"
220
271
  }
221
272
  }
222
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.0"
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
  ]
@@ -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",