feat: Rename database file to sqlite_mcp.db and clarify why database files are created

🔧 DATABASE FILENAME CHANGE:
- Changed default database name from 'database.db' to 'sqlite_mcp.db'
- More descriptive filename that clearly identifies its purpose
- Updated both start_sqlite_mcp.py and server.py defaults

📚 ENHANCED DOCUMENTATION:
- Added clear explanation of WHY database files are created
- 'MCP operations require persistent storage between tool calls'
- Clarified that tables, indexes, and data must persist between sessions
- Updated all examples and best practices to use sqlite_mcp.db

🎯 KEY BENEFITS:
- Clearer filename indicates this is for MCP server operations
- Users understand the necessity of persistent file storage
- Eliminates confusion about why a database file appears
- Maintains all existing functionality with better naming

The database file creation is essential for MCP functionality -
this update makes that purpose crystal clear to users.

Author: neverinfamous

README-Docker.md

@@ -5,8 +5,9 @@
 *Lightweight, containerized SQLite database server with AI-native features*
 
 ## 🚀 Zero-Configuration Database
-**No database setup required!** The server automatically creates and manages persistent SQLite databases:
-- **Auto-creates** database files as needed
+**No database setup required!** The server automatically creates and manages persistent SQLite databases **because MCP operations need persistent storage**:
+- **Auto-creates** `sqlite_mcp.db` files as needed (MCP tools require shared data storage)
+- **Why create a file?** Tables, indexes, and data must persist between MCP tool calls
 - **Persists all data** between container runs
 - **Connects to any existing** SQLite database
 - **Works immediately** - mount your data directory and go!

README.md

@@ -638,8 +638,9 @@ The server automatically detects project structure and creates appropriate datab
 The SQLite MCP Server provides flexible database configuration with **automatic database creation** - no manual setup required!
 
 ### **🚀 Zero-Configuration Start**
-The server automatically creates and manages a persistent SQLite database:
-- **Auto-creates** `database.db` in your project root if none exists
+The server automatically creates and manages a persistent SQLite database **because MCP operations require persistent storage** between tool calls:
+- **Auto-creates** `sqlite_mcp.db` in your project root if none exists
+- **Why create a file?** MCP tool calls need shared, persistent data storage (tables, indexes, etc.)
 - **Persists all data** between sessions and MCP tool calls  
 - **Works immediately** - no database setup or file creation needed
 - **Connects to existing databases** - works with any SQLite file you specify
@@ -654,13 +655,13 @@ python start_sqlite_mcp.py --db-path /path/to/your/database.db
 **Auto-detect project structure** (default):
 ```bash
 python start_sqlite_mcp.py
-# Automatically finds project root and creates database.db
+# Automatically finds project root and creates sqlite_mcp.db
 ```
 
 **Create organized data directory**:
 ```bash
 python start_sqlite_mcp.py --create-data-dir
-# Creates ./data/database.db in your project
+# Creates ./data/sqlite_mcp.db in your project
 ```
 
 ### MCP Client Configuration
@@ -699,8 +700,8 @@ python start_sqlite_mcp.py --create-data-dir
 
 ### Database Location Best Practices
 
-- **`./data/database.db`** - Recommended for projects (organized, version-control friendly)
-- **`./database.db`** - Simple option for small projects  
+- **`./data/sqlite_mcp.db`** - Recommended for projects (organized, version-control friendly)
+- **`./sqlite_mcp.db`** - Simple option for small projects  
 - **Existing databases** - Use `--db-path` to connect to any SQLite database
 - **`:memory:`** - Temporary database for testing (data not persisted)
 

src/mcp_server_sqlite/server.py

@@ -405,7 +405,7 @@ def _execute_query(self, query: str, params: Optional[Dict[str, Any]] = None) ->
             self.json_logger.log_error(e, {"query": query})
             raise
 
-async def main(db_path: str = "database.db"):
+async def main(db_path: str = "sqlite_mcp.db"):
     logger.info(f"Starting Enhanced SQLite MCP Server with DB: {db_path}")
 
     # Initialize database with enhanced features

start_sqlite_mcp.py

@@ -99,8 +99,8 @@ def get_default_db_path():
     parser.add_argument(
         '--db-name',
         type=str,
-        default='database.db',
-        help='Database filename (used with project-root, default: database.db)'
+        default='sqlite_mcp.db',
+        help='Database filename (used with project-root, default: sqlite_mcp.db)'
     )
 
     parser.add_argument(