Merge pull request #22 from modelcontextprotocol/garvan/sqlite-updates

Updated the SQLlite Server

src/sqlite/README.md

@@ -1,62 +1,54 @@
-# Simple SQLite Notes Server
+# SQLite MCP Server
 
-A basic MCP server implementation that demonstrates note-taking functionality using the three core MCP primitives: Resources, Prompts, and Tools.
+## Overview
+A Model Context Protocol (MCP) server implementation that provides database interaction and business intelligence capabilities through SQLite. This server enables running SQL queries, analyzing business data, and automatically generating business insight memos that can be enhanced with Claude's analysis when an Anthropic API key is provided.
 
-## Core Concepts
+## Components
 
 ### Resources
-Resources are how clients access data from the server. In this case, they're notes stored in SQLite.
-
-```python
-# Access notes through a custom URI scheme
-note:///example_note   # Gets the content of 'example_note'
-```
+The server exposes a single dynamic resource:
+- `memo://insights`: A continuously updated business insights memo that aggregates discovered insights during analysis
+  - Auto-updates as new insights are discovered via the append-insight tool
+  - Optional enhancement through Claude for professional formatting (requires Anthropic API key)
 
 ### Prompts
-Prompts allow generating text based on server state. Our server has a note summarization prompt that can be styled.
-
-```python
-# Example prompt with style argument
-{
-    "name": "summarize-notes",
-    "arguments": {
-        "style": "academic"  # Can be any style descriptor
-    }
-}
-```
+The server provides a demonstration prompt:
+- `mcp-demo`: Interactive prompt that guides users through database operations
+  - Required argument: `topic` - The business domain to analyze
+  - Generates appropriate database schemas and sample data
+  - Guides users through analysis and insight generation
+  - Integrates with the business insights memo
 
 ### Tools
-Tools modify server state. We have a simple tool to add new notes.
-
-```python
-# Adding a new note
-{
-    "name": "add-note",
-    "arguments": {
-        "name": "my_note",
-        "content": "This is my note content"
+The server offers six core tools:
+
+#### Query Tools
+- `read-query`: Execute SELECT queries on the database
+- `write-query`: Execute INSERT, UPDATE, or DELETE queries
+- `create-table`: Create new database tables
+
+#### Schema Tools
+- `list-tables`: Get a list of all tables in the database
+- `describe-table`: View the schema of a specific table
+
+#### Analysis Tools
+- `append-insight`: Add new business insights to the memo resource
+
+## Installation
+
+```bash
+# Add the server to your claude_desktop_config.json
+"mcpServers": {
+    "sqlite": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "parent_of_servers_repo/servers/src/sqlite",
+        "run",
+        "sqlite",
+        "--db-path",
+        "~/test.db"
+      ]
     }
-}
+  }
 ```
-
-## Key Implementation Details
-
-### Handler Registration
-All decorated handlers must be inside `__init__`:
-```python
-def __init__(self):
-    super().__init__("sqlite")
-
-    @self.list_resources()
-    async def handle_list_resources():
-        # Handler code here
-
-    @self.read_resource()
-    async def handle_read_resource():
-        # Handler code here
-```
-
-### Storage
-- Uses SQLite for persistent storage
-- Helper methods handle database operations
-- Clients are notified of state changes

src/sqlite/pyproject.toml

@@ -5,7 +5,7 @@ description = "A simple SQLite MCP server"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-    "mcp>=0.9.0",
+    "mcp>=0.9.1",
 ]
 
 [build-system]

src/sqlite/src/sqlite/__init__.py

@@ -1,10 +1,18 @@
 from . import server
 import asyncio
+import argparse
+import os
 
 
 def main():
     """Main entry point for the package."""
-    asyncio.run(server.main())
+    parser = argparse.ArgumentParser(description='SQLite MCP Server')
+    parser.add_argument('--db-path', 
+                       default="./sqlite_mcp_server.db",
+                       help='Path to SQLite database file')
+
+    args = parser.parse_args()
+    asyncio.run(server.main(args.db_path))
 
 
 # Optionally expose other important items at package level