spice-mcp 0.1.0__tar.gz → 0.1.2__tar.gz

{spice_mcp-0.1.0 → spice_mcp-0.1.2}/.gitignore

@@ -15,3 +15,9 @@ notes/*
 .pytest_cache/*
 tests/scripts/test_report.txt
 coverage*
+
+# Development tools and directories
+bin/
+.github/
+.factory/
+debug_api.py

{spice_mcp-0.1.0 → spice_mcp-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spice-mcp
-Version: 0.1.0
+Version: 0.1.2
 Summary: MCP server for Dune Analytics data access
 Author-email: Evan-Kim2028 <ekcopersonal@gmail.com>
 License-File: LICENSE
@@ -21,27 +21,87 @@ Description-Content-Type: text/markdown
 
 # spice-mcp
 
-spice-mcp is an MCP server for Dune Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery and Sui package exploration. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery and Sui package exploration. Results are Polars-first in Python and compact, token-efficient in MCP responses.
 
 Requirements: Python 3.13+
 
 This project uses FastMCP for typed, decorator-registered tools and resources.
 
-Highlights
+## Highlights
 - Polars LazyFrame-first pipeline: results stay lazy until explicitly materialized
-- Ports/adapters layering for maintainable integrations (`docs/architecture.md`)
+- Ports/adapters layering for maintainable integrations ([docs/architecture.md](docs/architecture.md))
 - Discovery utilities (find schemas/tables, describe columns)
 - Sui package workflows (events/transactions/objects) with safe defaults
 - JSONL query history + SQL artifacts (SHA-256) for reproducibility
 - Rich MCP surface: query info/run, discovery, health, Sui, and Dune admin (create/update/fork)
 
-Quick Start
+## What is Dune?
+[Dune](https://dune.com/) is a crypto data platform providing curated blockchain datasets and a public API to run and fetch query results. See the [Dune Docs](https://dune.com/docs) and [Dune API](https://dune.com/docs/api/) for full details.
+
+## Quick Start
 - Export `DUNE_API_KEY` in your shell (the server can also load a local `.env`; set `SPICE_MCP_SKIP_DOTENV=1` to skip during tests).
 - Install dependencies (`uv sync` or `pip install -e .`).
 - Start the FastMCP stdio server:
   - `python -m spice_mcp.mcp.server --env PYTHONPATH=$(pwd)/src`
   - or install the console script via `uv tool install .` and run `spice-mcp`.
 
+## Cursor IDE Setup
+
+To use spice-mcp with Cursor IDE:
+
+1. **Install the MCP Server**:
+   ```bash
+   # Install dependencies and package
+   uv sync
+   pip install -e .
+   
+   # Or install via uv tool (creates console script)
+   uv tool install .
+   ```
+
+2. **Configure Cursor**:
+   - Open Cursor Settings → MCP Servers
+   - Add new MCP server configuration:
+   ```json
+   {
+     "name": "spice-mcp",
+     "command": "spice-mcp",
+     "env": {
+       "DUNE_API_KEY": "your-dune-api-key-here"
+     },
+     "disabled": false
+   }
+   ```
+   Alternatively, if you prefer running from source:
+   ```json
+   {
+     "name": "spice-mcp", 
+     "command": "python",
+     "args": ["-m", "spice_mcp.mcp.server"],
+     "env": {
+       "PYTHONPATH": "/path/to/your/spice-mcp/src",
+       "DUNE_API_KEY": "your-dune-api-key-here"
+     },
+     "disabled": false
+   }
+   ```
+
+3. **Restart Cursor** to load the MCP server
+
+4. **Verify Connection**:
+   - Open Cursor and use the command palette (Cmd/Ctrl + Shift + P)
+   - Search for "MCP" or "spice" commands
+   - Test with `dune_health_check` to verify the connection
+
+5. **Available Tools in Cursor**:
+   - `dune_query`: Run Dune queries by ID, URL, or raw SQL
+   - `dune_find_tables`: Search schemas and list tables
+   - `dune_describe_table`: Get column metadata
+   - `sui_package_overview`: Analyze Sui packages
+   - `dune_health_check`: Verify API connection
+
+**Tip**: Create a `.env` file in your project root with `DUNE_API_KEY=your-key-here` for easier configuration.
+
 ## MCP Tools and Features
 
 All tools expose typed parameters, titles, and tags; failures return a consistent error envelope.
@@ -114,16 +174,16 @@ Core Tools (with parameters)
   - Use: Verify API key presence and logging paths
   - Output: `api_key_present`, `query_history_path`, `logging_enabled`, `status`
 
-Docs
-- See `docs/index.md` for full documentation:
-  - Dune API structure and capabilities: `docs/dune_api.md`
-  - Discovery patterns and examples: `docs/discovery.md`
-  - Sui package workflows: `docs/sui_packages.md`
-  - Tool reference and schemas: `docs/tools.md`
-  - Codex CLI + tooling integration: `docs/codex_cli.md`, `docs/codex_cli_tools.md`
-  - Architecture overview: `docs/architecture.md`
-  - Installation and configuration: `docs/installation.md`, `docs/config.md`
-  - Development and linting: `docs/development.md`
+## Docs
+- See [docs/index.md](docs/index.md) for full documentation:
+  - Dune API structure and capabilities: [docs/dune_api.md](docs/dune_api.md)
+  - Discovery patterns and examples: [docs/discovery.md](docs/discovery.md)
+  - Sui package workflows: [docs/sui_packages.md](docs/sui_packages.md)
+  - Tool reference and schemas: [docs/tools.md](docs/tools.md)
+  - Codex CLI + tooling integration: [docs/codex_cli.md](docs/codex_cli.md), [docs/codex_cli_tools.md](docs/codex_cli_tools.md)
+  - Architecture overview: [docs/architecture.md](docs/architecture.md)
+  - Installation and configuration: [docs/installation.md](docs/installation.md), [docs/config.md](docs/config.md)
+  - Development and linting: [docs/development.md](docs/development.md)
 
 Notes
 - Legacy Spice code now lives under `src/spice_mcp/adapters/dune` (extract, cache, urls, types).

{spice_mcp-0.1.0 → spice_mcp-0.1.2}/README.md

@@ -1,26 +1,86 @@
 # spice-mcp
 
-spice-mcp is an MCP server for Dune Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery and Sui package exploration. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery and Sui package exploration. Results are Polars-first in Python and compact, token-efficient in MCP responses.
 
 Requirements: Python 3.13+
 
 This project uses FastMCP for typed, decorator-registered tools and resources.
 
-Highlights
+## Highlights
 - Polars LazyFrame-first pipeline: results stay lazy until explicitly materialized
-- Ports/adapters layering for maintainable integrations (`docs/architecture.md`)
+- Ports/adapters layering for maintainable integrations ([docs/architecture.md](docs/architecture.md))
 - Discovery utilities (find schemas/tables, describe columns)
 - Sui package workflows (events/transactions/objects) with safe defaults
 - JSONL query history + SQL artifacts (SHA-256) for reproducibility
 - Rich MCP surface: query info/run, discovery, health, Sui, and Dune admin (create/update/fork)
 
-Quick Start
+## What is Dune?
+[Dune](https://dune.com/) is a crypto data platform providing curated blockchain datasets and a public API to run and fetch query results. See the [Dune Docs](https://dune.com/docs) and [Dune API](https://dune.com/docs/api/) for full details.
+
+## Quick Start
 - Export `DUNE_API_KEY` in your shell (the server can also load a local `.env`; set `SPICE_MCP_SKIP_DOTENV=1` to skip during tests).
 - Install dependencies (`uv sync` or `pip install -e .`).
 - Start the FastMCP stdio server:
   - `python -m spice_mcp.mcp.server --env PYTHONPATH=$(pwd)/src`
   - or install the console script via `uv tool install .` and run `spice-mcp`.
 
+## Cursor IDE Setup
+
+To use spice-mcp with Cursor IDE:
+
+1. **Install the MCP Server**:
+   ```bash
+   # Install dependencies and package
+   uv sync
+   pip install -e .
+   
+   # Or install via uv tool (creates console script)
+   uv tool install .
+   ```
+
+2. **Configure Cursor**:
+   - Open Cursor Settings → MCP Servers
+   - Add new MCP server configuration:
+   ```json
+   {
+     "name": "spice-mcp",
+     "command": "spice-mcp",
+     "env": {
+       "DUNE_API_KEY": "your-dune-api-key-here"
+     },
+     "disabled": false
+   }
+   ```
+   Alternatively, if you prefer running from source:
+   ```json
+   {
+     "name": "spice-mcp", 
+     "command": "python",
+     "args": ["-m", "spice_mcp.mcp.server"],
+     "env": {
+       "PYTHONPATH": "/path/to/your/spice-mcp/src",
+       "DUNE_API_KEY": "your-dune-api-key-here"
+     },
+     "disabled": false
+   }
+   ```
+
+3. **Restart Cursor** to load the MCP server
+
+4. **Verify Connection**:
+   - Open Cursor and use the command palette (Cmd/Ctrl + Shift + P)
+   - Search for "MCP" or "spice" commands
+   - Test with `dune_health_check` to verify the connection
+
+5. **Available Tools in Cursor**:
+   - `dune_query`: Run Dune queries by ID, URL, or raw SQL
+   - `dune_find_tables`: Search schemas and list tables
+   - `dune_describe_table`: Get column metadata
+   - `sui_package_overview`: Analyze Sui packages
+   - `dune_health_check`: Verify API connection
+
+**Tip**: Create a `.env` file in your project root with `DUNE_API_KEY=your-key-here` for easier configuration.
+
 ## MCP Tools and Features
 
 All tools expose typed parameters, titles, and tags; failures return a consistent error envelope.
@@ -93,16 +153,16 @@ Core Tools (with parameters)
   - Use: Verify API key presence and logging paths
   - Output: `api_key_present`, `query_history_path`, `logging_enabled`, `status`
 
-Docs
-- See `docs/index.md` for full documentation:
-  - Dune API structure and capabilities: `docs/dune_api.md`
-  - Discovery patterns and examples: `docs/discovery.md`
-  - Sui package workflows: `docs/sui_packages.md`
-  - Tool reference and schemas: `docs/tools.md`
-  - Codex CLI + tooling integration: `docs/codex_cli.md`, `docs/codex_cli_tools.md`
-  - Architecture overview: `docs/architecture.md`
-  - Installation and configuration: `docs/installation.md`, `docs/config.md`
-  - Development and linting: `docs/development.md`
+## Docs
+- See [docs/index.md](docs/index.md) for full documentation:
+  - Dune API structure and capabilities: [docs/dune_api.md](docs/dune_api.md)
+  - Discovery patterns and examples: [docs/discovery.md](docs/discovery.md)
+  - Sui package workflows: [docs/sui_packages.md](docs/sui_packages.md)
+  - Tool reference and schemas: [docs/tools.md](docs/tools.md)
+  - Codex CLI + tooling integration: [docs/codex_cli.md](docs/codex_cli.md), [docs/codex_cli_tools.md](docs/codex_cli_tools.md)
+  - Architecture overview: [docs/architecture.md](docs/architecture.md)
+  - Installation and configuration: [docs/installation.md](docs/installation.md), [docs/config.md](docs/config.md)
+  - Development and linting: [docs/development.md](docs/development.md)
 
 Notes
 - Legacy Spice code now lives under `src/spice_mcp/adapters/dune` (extract, cache, urls, types).

spice_mcp-0.1.2/debug_mcp_tool.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python3
+"""
+Debug script to test the MCP tool layer directly.
+"""
+
+import os
+import sys
+import json
+from pathlib import Path
+
+# Add src to path
+sys.path.insert(0, '/Users/evandekim/Documents/spice_mcp/src')
+
+from spice_mcp.config import Config
+from spice_mcp.logging.query_history import QueryHistory
+from spice_mcp.mcp.tools.execute_query import ExecuteQueryTool
+from spice_mcp.service_layer.query_service import QueryService
+from spice_mcp.adapters.dune.client import DuneAdapter
+
+def test_mcp_tool_directly():
+    """Test the MCP tool directly"""
+    
+    # Ensure API key is available
+    api_key = os.getenv('DUNE_API_KEY')
+    if not api_key:
+        print("❌ DUNE_API_KEY not set")
+        return False
+    
+    print("🔍 Testing MCP tool directly...")
+    
+    try:
+        # Setup the components
+        from spice_mcp.config import DuneConfig, CacheConfig, HttpClientConfig
+        config = Config(
+            dune=DuneConfig(api_key=api_key),
+            cache=CacheConfig(),
+            http=HttpClientConfig()
+        )
+        adapter = DuneAdapter(config)
+        query_service = QueryService(adapter)
+        query_history = QueryHistory(Path("/tmp/query_history.jsonl"), Path("/tmp/sql_artifacts"))
+        
+        # Create the tool
+        tool = ExecuteQueryTool(config, query_service, query_history)
+        
+        # Test simple raw SQL
+        print("\n📝 Testing MCP tool with 'SELECT 1 as test'")
+        
+        # This should work via the MCP tool interface
+        import asyncio
+        result = asyncio.run(tool.execute(
+            query="SELECT 1 as test",
+            refresh=True,
+            format="preview"
+        ))
+        
+        print(f"✅ Tool result type: {type(result)}")
+        print(f"✅ Tool result keys: {list(result.keys()) if isinstance(result, dict) else 'not dict'}")
+        
+        if isinstance(result, dict):
+            print(f"✅ Response type: {result.get('type')}")
+            print(f"✅ Row count: {result.get('rowcount')}")
+            print(f"✅ Execution ID: {result.get('execution_id')}")
+            if 'error' in result:
+                print(f"❌ Error: {result['error']}")
+                return False
+            else:
+                print("✅ Success! MCP tool executed raw SQL correctly")
+        
+    except Exception as e:
+        print(f"❌ MCP tool test failed: {e}")
+        print(f"   Error type: {type(e)}")
+        import traceback
+        traceback.print_exc()
+        return False
+    
+    return True
+
+def test_service_layer_directly():
+    """Test the service layer directly"""
+    
+    # Ensure API key is available
+    api_key = os.getenv('DUNE_API_KEY')
+    if not api_key:
+        print("❌ DUNE_API_KEY not set")
+        return False
+    
+    print("🔍 Testing service layer directly...")
+    
+    try:
+        # Setup the components
+        from spice_mcp.config import DuneConfig, CacheConfig, HttpClientConfig
+        config = Config(
+            dune=DuneConfig(api_key=api_key),
+            cache=CacheConfig(),
+            http=HttpClientConfig()
+        )
+        adapter = DuneAdapter(config)
+        query_service = QueryService(adapter)
+        
+        # Test service layer directly
+        print("\n📝 Testing service layer with 'SELECT 1 as test'")
+        
+        result = query_service.execute(
+            query="SELECT 1 as test",
+            refresh=True,
+            include_execution=True
+        )
+        
+        print(f"✅ Service result type: {type(result)}")
+        print(f"✅ Service result keys: {list(result.keys()) if isinstance(result, dict) else 'not dict'}")
+        
+        if isinstance(result, dict):
+            print(f"✅ Row count: {result.get('rowcount')}")
+            print(f"✅ Execution: {result.get('execution')}")
+            if 'execution' in result and result['execution'].get('execution_id'):
+                print("✅ Service layer executed successfully!")
+                return True
+            else:
+                print("❌ Service layer failed - no execution ID")
+                return False
+        
+    except Exception as e:
+        print(f"❌ Service layer test failed: {e}")
+        import traceback
+        traceback.print_exc()
+        return False
+    
+    return False
+
+if __name__ == "__main__":
+    print("🐛 Debugging spice-mcp MCP tool layer...")
+    
+    success = True
+    
+    # Test 1: Service layer
+    success &= test_service_layer_directly()
+    
+    # Test 2: MCP tool
+    success &= test_mcp_tool_directly()
+    
+    if success:
+        print("\n✅ All tests passed!")
+        sys.exit(0)
+    else:
+        print("\n❌ Some tests failed!")
+        sys.exit(1)

spice_mcp-0.1.2/debug_template_query.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python3
+"""
+Debug script to test template query 4060379 execution directly.
+"""
+
+import os
+import sys
+import json
+
+# Add src to path
+sys.path.insert(0, '/Users/evandekim/Documents/spice_mcp/src')
+
+from spice_mcp.adapters.dune import extract, urls
+
+def test_template_query_directly():
+    """Test the template query directly via extract.query()"""
+    
+    # Ensure API key is available
+    api_key = os.getenv('DUNE_API_KEY')
+    if not api_key:
+        print("❌ DUNE_API_KEY not set")
+        return False
+    
+    template_id = int(os.getenv("SPICE_RAW_SQL_QUERY_ID", "4060379"))
+    print(f"🔍 Testing template query {template_id} directly...")
+    
+    try:
+        # Test 1: Execute simple raw SQL
+        print("\n📝 Test 1: Simple SELECT 1")
+        result = extract.query(
+            query_or_execution="SELECT 1 as test",
+            verbose=True,
+            refresh=True,
+            poll=True,
+            api_key=api_key,
+            timeout_seconds=30
+        )
+        
+        print(f"✅ Result type: {type(result)}")
+        if hasattr(result, 'shape'):
+            print(f"✅ Result shape: {result.shape}")
+        print(f"✅ Result columns: {list(result.columns) if hasattr(result, 'columns') else 'N/A'}")
+        
+    except Exception as e:
+        print(f"❌ Test 1 failed: {e}")
+        print(f"   Error type: {type(e)}")
+        return False
+    
+    try:
+        # Test 2: Test with parameters explicitly
+        print("\n📝 Test 2: Raw SQL with explicit parameters")
+        result = extract.query(
+            query_or_execution="SELECT 1 as test",
+            verbose=True,
+            refresh=True,
+            poll=True,
+            api_key=api_key,
+            parameters={'query': 'SELECT 1 as test'},
+            timeout_seconds=30
+        )
+        
+        print(f"✅ Result type: {type(result)}")
+        if hasattr(result, 'shape'):
+            print(f"✅ Result shape: {result.shape}")
+            
+    except Exception as e:
+        print(f"❌ Test 2 failed: {e}")
+        return False
+    
+    return True
+
+def test_determine_input_type():
+    """Test the determine_input_type function"""
+    print("\n🔍 Testing determine_input_type...")
+    
+    query_id, execution, parameters = extract.determine_input_type("SELECT 1 as test")
+    
+    print(f"✅ Query ID: {query_id}")
+    print(f"✅ Execution: {execution}")
+    print(f"✅ Parameters: {parameters}")
+    
+    return True
+
+def test_template_query_api_check():
+    """Check if the template query actually exists and is accessible"""
+    template_id = int(os.getenv("SPICE_RAW_SQL_QUERY_ID", "4060379"))
+    api_key = os.getenv('DUNE_API_KEY')
+    
+    if not api_key:
+        print("❌ DUNE_API_KEY not set")
+        return False
+        
+    print(f"\n🔍 Checking template query {template_id} metadata...")
+    
+    try:
+        # Check if the query exists by trying to get its info
+        url = urls.get_query_execute_url(template_id)
+        headers = {'X-Dune-API-Key': api_key, 'User-Agent': extract.get_user_agent()}
+        
+        print(f"🌐 Query execute URL: {url}")
+        
+        # Try to execute with empty parameters first
+        import requests
+        
+        response = requests.post(
+            url, 
+            headers=headers,
+            json={'query_parameters': {}, 'performance': 'medium'},
+            timeout=30
+        )
+        
+        print(f"📊 Status code: {response.status_code}")
+        
+        if response.status_code == 200:
+            result = response.json()
+            print(f"✅ Execution result: {json.dumps(result, indent=2)}")
+        else:
+            print(f"❌ API Response: {response.text}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ Template query check failed: {e}")
+        return False
+    
+    return True
+
+if __name__ == "__main__":
+    print("🐛 Debugging spice-mcp raw SQL execution issues...")
+    
+    success = True
+    
+    # Test 1: Determine input type
+    success &= test_determine_input_type()
+    
+    # Test 2: Check template query API
+    success &= test_template_query_api_check()
+    
+    # Test 3: Direct execution
+    print(f"\n🚀 About to test raw SQL execution...")
+    success &= test_template_query_directly()
+    
+    if success:
+        print("\n✅ All tests passed!")
+        sys.exit(0)
+    else:
+        print("\n❌ Some tests failed!")
+        sys.exit(1)

spice_mcp-0.1.2/issue_diagnostics.py

@@ -0,0 +1,76 @@
+# Raw SQL Execution Issue Analysis
+
+## ✅ GOOD NEWS: Core Code is Working Correctly!
+
+After extensive debugging, I've determined that the core spice-mcp code is **working perfectly**. Both the Dune adapter layer and MCP tool layer successfully execute raw SQL queries when properly configured.
+
+## 🐛 Root Cause: Environmental/Configuration Issue
+
+The issue reported in #6 is **not in the code itself** but rather in how users are running the MCP server. The symptoms suggest:
+
+1. **Environment variable issue**: `SPICE_RAW_SQL_QUERY_ID` may not be set in the MCP server context
+2. **MCP server setup issue**: The FastMCP server may not be properly configured
+3. **Path/import issues**: The MCP server may be running in a different environment
+
+## 🔧 Proposed Solutions
+
+### Option 1: Hard-code fallback (Recommended)
+Make the template ID resolution more robust by providing a fallback:
+
+```python
+def resolve_raw_sql_template_id() -> int:
+    """Return a stable template ID used for executing raw SQL text."""
+    # Try environment variable first, fallback to hardcoded value
+    env_value = os.getenv("SPICE_RAW_SQL_QUERY_ID")
+    if env_value and env_value.strip():
+        try:
+            return int(env_value.strip())
+        except ValueError:
+            pass
+    # Fallback to known working template ID
+    return 4060379
+```
+
+### Option 2: Enhanced Diagnostics
+Add better error reporting in the MCP tool to help users debug their setup:
+
+```python
+# Add environment variable check at tool startup
+if not os.getenv("SPICE_RAW_SQL_QUERY_ID"):
+    print("Warning: SPICE_RAW_SQL_QUERY_ID not set, using default template ID")
+```
+
+### Option 3: Verify Tool
+Create a verification tool that tests the raw SQL path:
+
+```python
+def verify_raw_sql_config(self) -> dict:
+    """Verify that raw SQL configuration is working."""
+    try:
+        template_id = resolve_raw_sql_template_id()
+        return {
+            "status": "ok",
+            "template_id": template_id,
+            "env_var_set": bool(os.getenv("SPICE_RAW_SQL_QUERY_ID"))
+        }
+    except Exception as e:
+        return {"status": "error", "error": str(e)}
+```
+
+## 🎯 User Action Required
+
+For users experiencing this issue:
+
+1. **Set environment variable properly in MCP server context**
+2. **Verify MCP server startup logs** for any authentication or import errors
+3. **Use the enhanced diagnostics** (once implemented)
+
+## 📋 Test Results Summary
+
+- ✅ Template ID resolution: Working
+- ✅ Dune adapter raw SQL: Working  
+- ✅ MCP tool raw SQL: Working
+- ✅ Service layer: Working
+- ❌ User environment: Needs investigation
+
+The fix in 0.1.1 addressed the core issue. The remaining problem is likely user environment specific.

{spice_mcp-0.1.0 → spice_mcp-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "spice-mcp"
-version = "0.1.0"
+version = "0.1.2"
 description = "MCP server for Dune Analytics data access"
 authors = [
     { name = "Evan-Kim2028", email = "ekcopersonal@gmail.com" }
@@ -36,6 +36,23 @@ managed = true
 dev-dependencies = [
     "pytest>=8.0.0",
     "pytest-asyncio>=0.23.0",
+    "pytest-cov>=5.0.0",
+    "freezegun>=1.4.0",
+    "jsonschema>=4.21.1",
+    "responses>=0.25.0",
+    "aioresponses>=0.7.6",
+    "vcrpy>=6.0.1",
+    "hypothesis>=6.100.0",
+    "ruff>=0.6.9",
+    "mypy>=1.11.2",
+]
+
+# uv dependency groups for CI and local dev
+[dependency-groups]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=5.0.0",
     "freezegun>=1.4.0",
     "jsonschema>=4.21.1",
     "responses>=0.25.0",