Local MCP check

README.md

@@ -114,12 +114,12 @@ Start the HTTP API server:
 cd backend
 JWT_SECRET_KEY="local-dev-secret-key-123" \
 VAULT_BASE_PATH="$(pwd)/../data/vaults" \
-.venv/bin/uvicorn src.api.main:app --host 0.0.0.0 --port 8000 --reload
+.venv/bin/uvicorn src.api.main:app --host 0.0.0.0 --port 8001 --reload
 ```
 
-Backend will be available at: `http://localhost:8000`
+Backend will be available at: `http://localhost:8001`
 
-API docs (Swagger): `http://localhost:8000/docs`
+API docs (Swagger): `http://localhost:8001/docs`
 
 #### Running MCP Server (STDIO Mode)
 
@@ -332,7 +332,7 @@ write_note(
 - Verify database is initialized
 
 **Frontend shows connection errors:**
-- Ensure backend is running on port 8000
+- Ensure backend is running on port 8001
 - Check Vite proxy configuration in `frontend/vite.config.ts`
 
 **Search returns no results:**

backend/main.py

@@ -1,6 +1,11 @@
-def main():
-    print("Hello from backend!")
+"""Entry point for running the FastAPI application."""
 
+import uvicorn
 
 if __name__ == "__main__":
-    main()
+    uvicorn.run(
+        "src.api.main:app",
+        host="0.0.0.0",
+        port=8000,
+        reload=True,
+    )

backend/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "backend"
+name = "Documentation-MCP"
 version = "0.1.0"
 description = "Add your description here"
 readme = "README.md"
@@ -8,7 +8,9 @@ dependencies = [
     "fastapi>=0.121.2",
     "fastmcp>=2.13.1",
     "huggingface-hub>=1.1.4",
+    "mcp>=1.21.0",
     "pyjwt>=2.10.1",
+    "python-dotenv>=1.0.0",
     "python-frontmatter>=1.1.0",
     "uvicorn[standard]>=0.38.0",
 ]

backend/requirements.txt

@@ -6,4 +6,7 @@ huggingface_hub
 uvicorn
 httpx
 pytest
-pytest-asyncio
+pytest-asyncio
+python-dotenv
+requests
+sqlite

backend/src/api/main.py

@@ -10,10 +10,15 @@ from fastapi import FastAPI, HTTPException, Request
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import JSONResponse
 from fastapi.staticfiles import StaticFiles
-from fastapi.routing import ASGIRoute
+from dotenv import load_dotenv
+
+load_dotenv()  # Add this line at the top, before other imports
+
+# from fastapi.routing import ASGIRoute
 from starlette.responses import Response
 
-from fastmcp.server.streamable_http import StreamableHTTPSessionManager
+from fastmcp.server.http import StreamableHTTPSessionManager
+from fastapi.responses import FileResponse
 
 from .routes import auth, index, notes, search
 from ..mcp.server import mcp
@@ -30,7 +35,11 @@ app = FastAPI(
 # CORS middleware
 app.add_middleware(
     CORSMiddleware,
-    allow_origins=["http://localhost:5173", "http://localhost:3000", "https://huggingface.co"],
+    allow_origins=[
+        "http://localhost:5173",
+        "http://localhost:3000",
+        "https://huggingface.co",
+    ],
     allow_credentials=True,
     allow_methods=["*"],
     allow_headers=["*"],
@@ -137,34 +146,38 @@ async def health():
     return {"status": "healthy"}
 
 
-# Serve frontend static files with SPA support (must be last to not override API routes)
-from fastapi.responses import FileResponse
-
 frontend_dist = Path(__file__).resolve().parents[3] / "frontend" / "dist"
 if frontend_dist.exists():
     # Mount static assets
-    app.mount("/assets", StaticFiles(directory=str(frontend_dist / "assets")), name="assets")
-    
+    app.mount(
+        "/assets", StaticFiles(directory=str(frontend_dist / "assets")), name="assets"
+    )
+
     # Catch-all route for SPA - serve index.html for all non-API routes
     @app.get("/{full_path:path}")
     async def serve_spa(full_path: str):
         """Serve the SPA for all non-API routes."""
         # Don't intercept API or auth routes
-        if full_path.startswith(("api/", "auth/", "health", "mcp")):
+        if (
+            full_path.startswith(("api/", "auth/"))
+            or full_path == "health"
+            or full_path.startswith("mcp/")
+            or full_path == "mcp"
+        ):
             # Let FastAPI's 404 handler take over
             raise HTTPException(status_code=404, detail="Not found")
-        
+
         # If the path looks like a file (has extension), try to serve it
         file_path = frontend_dist / full_path
         if file_path.is_file():
             return FileResponse(file_path)
         # Otherwise serve index.html for SPA routing
         return FileResponse(frontend_dist / "index.html")
-    
+
     logger.info(f"Serving frontend SPA from: {frontend_dist}")
 else:
     logger.warning(f"Frontend dist not found at: {frontend_dist}")
-    
+
     # Fallback health endpoint if no frontend
     @app.get("/")
     async def root():
@@ -173,4 +186,3 @@ else:
 
 
 __all__ = ["app"]
-

backend/src/api/routes/auth.py

@@ -15,7 +15,7 @@ from fastapi.responses import RedirectResponse
 
 from ...models.auth import TokenResponse
 from ...models.user import HFProfile, User
-from ...services.auth import AuthService
+from ...services.auth import AuthError, AuthService
 from ...services.config import get_config
 from ...services.seed import ensure_welcome_note
 from ...services.vault import VaultService
@@ -35,7 +35,11 @@ def _create_oauth_state() -> str:
     """Generate a state token and store it with a timestamp."""
     now = time.time()
     # Garbage collect expired states
-    expired = [state for state, ts in oauth_states.items() if now - ts > OAUTH_STATE_TTL_SECONDS]
+    expired = [
+        state
+        for state, ts in oauth_states.items()
+        if now - ts > OAUTH_STATE_TTL_SECONDS
+    ]
     for state in expired:
         oauth_states.pop(state, None)
 
@@ -55,24 +59,24 @@ def _consume_oauth_state(state: str | None) -> None:
 def get_base_url(request: Request) -> str:
     """
     Get the base URL for OAuth redirects.
-    
+
     Uses the actual request URL scheme and hostname from FastAPI's request.url.
     HF Spaces doesn't set X-Forwarded-Host, but the 'host' header is correct.
     """
     # Get scheme from X-Forwarded-Proto or request
     forwarded_proto = request.headers.get("x-forwarded-proto")
     scheme = forwarded_proto if forwarded_proto else str(request.url.scheme)
-    
+
     # Get hostname from request URL (this comes from the 'host' header)
     hostname = str(request.url.hostname)
-    
+
     # Check for port (but HF Spaces uses standard 443 for HTTPS)
     port = request.url.port
     if port and port not in (80, 443):
         base_url = f"{scheme}://{hostname}:{port}"
     else:
         base_url = f"{scheme}://{hostname}"
-    
+
     logger.info(
         f"OAuth base URL detected: {base_url}",
         extra={
@@ -80,9 +84,9 @@ def get_base_url(request: Request) -> str:
             "hostname": hostname,
             "port": port,
             "request_url": str(request.url),
-        }
+        },
     )
-    
+
     return base_url
 
 
@@ -90,13 +94,13 @@ def get_base_url(request: Request) -> str:
 async def login(request: Request):
     """Redirect to Hugging Face OAuth authorization page."""
     config = get_config()
-    
+
     if not config.hf_oauth_client_id:
         raise HTTPException(
             status_code=501,
-            detail="OAuth not configured. Set HF_OAUTH_CLIENT_ID and HF_OAUTH_CLIENT_SECRET environment variables."
+            detail="OAuth not configured. Set HF_OAUTH_CLIENT_ID and HF_OAUTH_CLIENT_SECRET environment variables.",
         )
-    
+
     # Get base URL from request (handles HF Spaces proxy)
     base_url = get_base_url(request)
     redirect_uri = f"{base_url}/auth/callback"
@@ -112,7 +116,7 @@ async def login(request: Request):
         "response_type": "code",
         "state": state,
     }
-    
+
     auth_url = f"{oauth_base}?{urlencode(params)}"
     logger.info(
         "Initiating OAuth flow",
@@ -121,9 +125,9 @@ async def login(request: Request):
             "auth_url": auth_url,
             "client_id": config.hf_oauth_client_id[:8] + "...",
             "state": state,
-        }
+        },
     )
-    
+
     return RedirectResponse(url=auth_url, status_code=302)
 
 
@@ -131,21 +135,20 @@ async def login(request: Request):
 async def callback(
     request: Request,
     code: str = Query(..., description="OAuth authorization code"),
-    state: Optional[str] = Query(None, description="State parameter for CSRF protection"),
+    state: Optional[str] = Query(
+        None, description="State parameter for CSRF protection"
+    ),
 ):
     """Handle OAuth callback from Hugging Face."""
     config = get_config()
-    
+
     if not config.hf_oauth_client_id or not config.hf_oauth_client_secret:
-        raise HTTPException(
-            status_code=501,
-            detail="OAuth not configured"
-        )
-    
+        raise HTTPException(status_code=501, detail="OAuth not configured")
+
     # Get base URL from request (must match the one sent to HF)
     base_url = get_base_url(request)
     redirect_uri = f"{base_url}/auth/callback"
-    
+
     # Validate state token to prevent CSRF and replay attacks
     _consume_oauth_state(state)
 
@@ -155,9 +158,9 @@ async def callback(
             "redirect_uri": redirect_uri,
             "state": state,
             "code_length": len(code) if code else 0,
-        }
+        },
     )
-    
+
     try:
         # Exchange authorization code for access token
         async with httpx.AsyncClient() as client:
@@ -171,50 +174,47 @@ async def callback(
                     "client_secret": config.hf_oauth_client_secret,
                 },
             )
-            
+
             if token_response.status_code != 200:
                 logger.error(f"Token exchange failed: {token_response.text}")
                 raise HTTPException(
                     status_code=400,
-                    detail="Failed to exchange authorization code for token"
+                    detail="Failed to exchange authorization code for token",
                 )
-            
+
             token_data = token_response.json()
             access_token = token_data.get("access_token")
-            
+
             if not access_token:
                 raise HTTPException(
-                    status_code=400,
-                    detail="No access token in response"
+                    status_code=400, detail="No access token in response"
                 )
-            
+
             # Get user profile from HF
             user_response = await client.get(
                 "https://huggingface.co/api/whoami-v2",
-                headers={"Authorization": f"Bearer {access_token}"}
+                headers={"Authorization": f"Bearer {access_token}"},
             )
-            
+
             if user_response.status_code != 200:
                 logger.error(f"User profile fetch failed: {user_response.text}")
                 raise HTTPException(
-                    status_code=400,
-                    detail="Failed to fetch user profile"
+                    status_code=400, detail="Failed to fetch user profile"
                 )
-            
+
             user_data = user_response.json()
             username = user_data.get("name")
             email = user_data.get("email")
-            
+
             if not username:
                 raise HTTPException(
-                    status_code=400,
-                    detail="No username in user profile"
+                    status_code=400, detail="No username in user profile"
                 )
-            
+
             # Create JWT for our application
             import jwt
             from datetime import datetime, timedelta, timezone
-            
+
             user_id = username  # Use HF username as user_id
 
             # Ensure the user has an initialized vault with a welcome note
@@ -237,36 +237,37 @@ async def callback(
                 "exp": datetime.now(timezone.utc) + timedelta(days=7),
                 "iat": datetime.now(timezone.utc),
             }
-            
-            jwt_token = jwt.encode(payload, config.jwt_secret_key, algorithm="HS256")
-            
+
+            try:
+                jwt_secret = auth_service._require_secret()
+            except AuthError as exc:
+                raise HTTPException(status_code=exc.status_code, detail=exc.message)
+
+            jwt_token = jwt.encode(payload, jwt_secret, algorithm="HS256")
+
             logger.info(
                 "OAuth successful",
                 extra={
                     "username": username,
                     "user_id": user_id,
                     "email": email,
-                }
+                },
             )
-            
+
             # Redirect to frontend with token in URL hash
             frontend_url = base_url
             redirect_url = f"{frontend_url}/#token={jwt_token}"
             logger.info(f"Redirecting to frontend: {redirect_url}")
             return RedirectResponse(url=redirect_url, status_code=302)
-    
+
     except httpx.HTTPError as e:
         logger.exception(f"HTTP error during OAuth: {e}")
         raise HTTPException(
-            status_code=500,
-            detail="OAuth flow failed due to network error"
+            status_code=500, detail="OAuth flow failed due to network error"
         )
     except Exception as e:
         logger.exception(f"Unexpected error during OAuth: {e}")
-        raise HTTPException(
-            status_code=500,
-            detail="OAuth flow failed"
-        )
+        raise HTTPException(status_code=500, detail="OAuth flow failed")
 
 
 @router.post("/api/tokens", response_model=TokenResponse)
@@ -310,4 +311,3 @@ async def get_current_user(auth: AuthContext = Depends(get_auth_context)):
 
 
 __all__ = ["router"]
-

backend/src/mcp/server.py

@@ -7,9 +7,13 @@ import os
 import time
 from typing import Any, Dict, List, Optional
 
+from dotenv import load_dotenv
 from fastmcp import FastMCP
 from pydantic import Field
 
+# Load environment variables from .env file
+load_dotenv()
+
 from ..services import IndexerService, VaultNote, VaultService
 from ..services.auth import AuthError, AuthService
 
@@ -72,7 +76,10 @@ def _note_to_response(note: VaultNote) -> Dict[str, Any]:
     }
 
 
-@mcp.tool(name="list_notes", description="List notes in the vault (optionally scoped to a folder).")
+@mcp.tool(
+    name="list_notes",
+    description="List notes in the vault (optionally scoped to a folder).",
+)
 def list_notes(
     folder: Optional[str] = Field(
         default=None,
@@ -81,9 +88,9 @@ def list_notes(
 ) -> List[Dict[str, Any]]:
     start_time = time.time()
     user_id = _current_user_id()
-    
+
     notes = vault_service.list_notes(user_id, folder=folder)
-    
+
     duration_ms = (time.time() - start_time) * 1000
     logger.info(
         "MCP tool called",
@@ -92,10 +99,10 @@ def list_notes(
             "user_id": user_id,
             "folder": folder or "(root)",
             "result_count": len(notes),
-            "duration_ms": f"{duration_ms:.2f}"
-        }
+            "duration_ms": f"{duration_ms:.2f}",
+        },
     )
-    
+
     return [
         {
             "path": entry["path"],
@@ -108,13 +115,15 @@ def list_notes(
 
 @mcp.tool(name="read_note", description="Read a Markdown note with metadata and body.")
 def read_note(
-    path: str = Field(..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."),
+    path: str = Field(
+        ..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."
+    ),
 ) -> Dict[str, Any]:
     start_time = time.time()
     user_id = _current_user_id()
-    
+
     note = vault_service.read_note(user_id, path)
-    
+
     duration_ms = (time.time() - start_time) * 1000
     logger.info(
         "MCP tool called",
@@ -122,10 +131,10 @@ def read_note(
             "tool_name": "read_note",
             "user_id": user_id,
             "note_path": path,
-            "duration_ms": f"{duration_ms:.2f}"
-        }
+            "duration_ms": f"{duration_ms:.2f}",
+        },
     )
-    
+
     return _note_to_response(note)
 
 
@@ -134,7 +143,9 @@ def read_note(
     description="Create or update a note. Automatically updates frontmatter timestamps and search index.",
 )
 def write_note(
-    path: str = Field(..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."),
+    path: str = Field(
+        ..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."
+    ),
     body: str = Field(..., description="Markdown body ≤1 MiB."),
     title: Optional[str] = Field(
         default=None,
@@ -147,7 +158,7 @@ def write_note(
 ) -> Dict[str, Any]:
     start_time = time.time()
     user_id = _current_user_id()
-    
+
     note = vault_service.write_note(
         user_id,
         path,
@@ -156,7 +167,7 @@ def write_note(
         body=body,
     )
     indexer_service.index_note(user_id, note)
-    
+
     duration_ms = (time.time() - start_time) * 1000
     logger.info(
         "MCP tool called",
@@ -164,23 +175,25 @@ def write_note(
             "tool_name": "write_note",
             "user_id": user_id,
             "note_path": path,
-            "duration_ms": f"{duration_ms:.2f}"
-        }
+            "duration_ms": f"{duration_ms:.2f}",
+        },
     )
-    
+
     return {"status": "ok", "path": path}
 
 
 @mcp.tool(name="delete_note", description="Delete a note and remove it from the index.")
 def delete_note(
-    path: str = Field(..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."),
+    path: str = Field(
+        ..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."
+    ),
 ) -> Dict[str, str]:
     start_time = time.time()
     user_id = _current_user_id()
-    
+
     vault_service.delete_note(user_id, path)
     indexer_service.delete_note_index(user_id, path)
-    
+
     duration_ms = (time.time() - start_time) * 1000
     logger.info(
         "MCP tool called",
@@ -188,10 +201,10 @@ def delete_note(
             "tool_name": "delete_note",
             "user_id": user_id,
             "note_path": path,
-            "duration_ms": f"{duration_ms:.2f}"
-        }
+            "duration_ms": f"{duration_ms:.2f}",
+        },
     )
-    
+
     return {"status": "ok"}
 
 
@@ -205,9 +218,9 @@ def search_notes(
 ) -> List[Dict[str, Any]]:
     start_time = time.time()
     user_id = _current_user_id()
-    
+
     results = indexer_service.search_notes(user_id, query, limit=limit)
-    
+
     duration_ms = (time.time() - start_time) * 1000
     logger.info(
         "MCP tool called",
@@ -217,10 +230,10 @@ def search_notes(
             "query": query,
             "limit": limit,
             "result_count": len(results),
-            "duration_ms": f"{duration_ms:.2f}"
-        }
+            "duration_ms": f"{duration_ms:.2f}",
+        },
     )
-    
+
     return [
         {
             "path": row["path"],
@@ -231,9 +244,13 @@ def search_notes(
     ]
 
 
-@mcp.tool(name="get_backlinks", description="List notes that reference the target note.")
+@mcp.tool(
+    name="get_backlinks", description="List notes that reference the target note."
+)
 def get_backlinks(
-    path: str = Field(..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."),
+    path: str = Field(
+        ..., description="Relative '.md' path ≤256 chars (no '..' or '\\')."
+    ),
 ) -> List[Dict[str, Any]]:
     user_id = _current_user_id()
     backlinks = indexer_service.get_backlinks(user_id, path)
@@ -247,4 +264,17 @@ def get_tags() -> List[Dict[str, Any]]:
 
 
 if __name__ == "__main__":
-    mcp.run(transport="stdio")
+    transport = os.getenv("MCP_TRANSPORT", "stdio").strip().lower() or "stdio"
+
+    # Configure HTTP transport with custom port if specified
+    if transport == "http":
+        port = int(os.getenv("MCP_PORT", "8001"))
+        host = os.getenv("MCP_HOST", "127.0.0.1")
+        logger.info(
+            "Starting MCP server",
+            extra={"transport": transport, "host": host, "port": port},
+        )
+        mcp.run(transport=transport, host=host, port=port)
+    else:
+        logger.info("Starting MCP server", extra={"transport": transport})
+        mcp.run(transport=transport)

backend/src/services/auth.py

@@ -44,9 +44,25 @@ class AuthService:
         self.algorithm = algorithm
         self.token_ttl_days = token_ttl_days
 
+    @property
+    def _local_mode_enabled(self) -> bool:
+        return bool(self.config.enable_local_mode)
+
+    @property
+    def _local_dev_token(self) -> Optional[str]:
+        token = self.config.local_dev_token
+        return token.strip() if token else None
+
     def _require_secret(self) -> str:
         secret = self.config.jwt_secret_key
         if not secret:
+            if self._local_mode_enabled and self._local_dev_token:
+                # Local mode can operate without JWT secret for read-only flows.
+                raise AuthError(
+                    "missing_jwt_secret",
+                    "JWT secret is not configured; set JWT_SECRET_KEY to enable JWT issuance",
+                    status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+                )
             raise AuthError(
                 "missing_jwt_secret",
                 "JWT secret is not configured; set JWT_SECRET_KEY to enable authentication features",
@@ -65,6 +81,14 @@ class AuthService:
             exp=int((now + lifetime).timestamp()),
         )
 
+    def _local_dev_payload(self) -> JWTPayload:
+        now = datetime.now(timezone.utc)
+        return JWTPayload(
+            sub="local-dev",
+            iat=int(now.timestamp()),
+            exp=int((now + timedelta(days=365)).timestamp()),
+        )
+
     def create_jwt(self, user_id: str, *, expires_in: Optional[timedelta] = None) -> str:
         """Create a signed JWT for the given user."""
         payload = self._build_payload(user_id, expires_in)
@@ -76,6 +100,9 @@ class AuthService:
 
     def validate_jwt(self, token: str) -> JWTPayload:
         """Validate a JWT and return the decoded payload."""
+        if self._local_mode_enabled and self._local_dev_token:
+            if token == self._local_dev_token:
+                return self._local_dev_payload()
         try:
             decoded = jwt.decode(
                 token,

backend/src/services/config.py

@@ -22,6 +22,14 @@ class AppConfig(BaseModel):
         default=None,
         description="HMAC secret for JWT signing (required for JWT/HTTP auth)",
     )
+    enable_local_mode: bool = Field(
+        default=True,
+        description="Allow local-dev token bypass when running locally",
+    )
+    local_dev_token: Optional[str] = Field(
+        default="local-dev-token",
+        description="Static token accepted in local mode for development",
+    )
     vault_base_path: Path = Field(..., description="Base directory for per-user vaults")
     hf_oauth_client_id: Optional[str] = Field(
         None, description="Hugging Face OAuth client ID (optional)"
@@ -72,9 +80,17 @@ def get_config() -> AppConfig:
     hf_client_id = _read_env("HF_OAUTH_CLIENT_ID")
     hf_client_secret = _read_env("HF_OAUTH_CLIENT_SECRET")
     hf_space_url = _read_env("HF_SPACE_URL", "http://localhost:5173")
+    enable_local_mode = _read_env("ENABLE_LOCAL_MODE", "true").lower() not in {
+        "0",
+        "false",
+        "no",
+    }
+    local_dev_token = _read_env("LOCAL_DEV_TOKEN", "local-dev-token")
 
     config = AppConfig(
         jwt_secret_key=jwt_secret,
+        enable_local_mode=enable_local_mode,
+        local_dev_token=local_dev_token,
         vault_base_path=vault_base,
         hf_oauth_client_id=hf_client_id,
         hf_oauth_client_secret=hf_client_secret,

backend/uv.lock

@@ -55,43 +55,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/f8/aa/5082412d1ee302e9e7d80b6949bc4d2a8fa1149aaab610c5fc24709605d6/authlib-1.6.5-py2.py3-none-any.whl", hash = "sha256:3e0e0507807f842b02175507bdee8957a1d5707fd4afb17c32fb43fee90b6e3a", size = 243608, upload-time = "2025-10-02T13:36:07.637Z" },
 ]
 
-[[package]]
-name = "backend"
-version = "0.1.0"
-source = { virtual = "." }
-dependencies = [
-    { name = "fastapi" },
-    { name = "fastmcp" },
-    { name = "huggingface-hub" },
-    { name = "pyjwt" },
-    { name = "python-frontmatter" },
-    { name = "uvicorn", extra = ["standard"] },
-]
-
-[package.dev-dependencies]
-dev = [
-    { name = "httpx" },
-    { name = "pytest" },
-    { name = "pytest-asyncio" },
-]
-
-[package.metadata]
-requires-dist = [
-    { name = "fastapi", specifier = ">=0.121.2" },
-    { name = "fastmcp", specifier = ">=2.13.1" },
-    { name = "huggingface-hub", specifier = ">=1.1.4" },
-    { name = "pyjwt", specifier = ">=2.10.1" },
-    { name = "python-frontmatter", specifier = ">=1.1.0" },
-    { name = "uvicorn", extras = ["standard"], specifier = ">=0.38.0" },
-]
-
-[package.metadata.requires-dev]
-dev = [
-    { name = "httpx", specifier = ">=0.28.1" },
-    { name = "pytest", specifier = ">=9.0.1" },
-    { name = "pytest-asyncio", specifier = ">=1.3.0" },
-]
-
 [[package]]
 name = "backports-tarfile"
 version = "1.2.0"
@@ -396,6 +359,47 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/55/e2/2537ebcff11c1ee1ff17d8d0b6f4db75873e3b0fb32c2d4a2ee31ecb310a/docstring_parser-0.17.0-py3-none-any.whl", hash = "sha256:cf2569abd23dce8099b300f9b4fa8191e9582dda731fd533daf54c4551658708", size = 36896, upload-time = "2025-07-21T07:35:00.684Z" },
 ]
 
+[[package]]
+name = "documentation-mcp"
+version = "0.1.0"
+source = { virtual = "." }
+dependencies = [
+    { name = "fastapi" },
+    { name = "fastmcp" },
+    { name = "huggingface-hub" },
+    { name = "mcp" },
+    { name = "pyjwt" },
+    { name = "python-dotenv" },
+    { name = "python-frontmatter" },
+    { name = "uvicorn", extra = ["standard"] },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "httpx" },
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "fastapi", specifier = ">=0.121.2" },
+    { name = "fastmcp", specifier = ">=2.13.1" },
+    { name = "huggingface-hub", specifier = ">=1.1.4" },
+    { name = "mcp", specifier = ">=1.21.0" },
+    { name = "pyjwt", specifier = ">=2.10.1" },
+    { name = "python-dotenv", specifier = ">=1.0.0" },
+    { name = "python-frontmatter", specifier = ">=1.1.0" },
+    { name = "uvicorn", extras = ["standard"], specifier = ">=0.38.0" },
+]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "httpx", specifier = ">=0.28.1" },
+    { name = "pytest", specifier = ">=9.0.1" },
+    { name = "pytest-asyncio", specifier = ">=1.3.0" },
+]
+
 [[package]]
 name = "docutils"
 version = "0.22.3"
@@ -1298,7 +1302,7 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/56/f9/a0f1ca194c50aa29895b442771f036a25b6c41a35e4f35b1a0ea713bedae/rpds_py-0.28.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:d678e91b610c29c4b3d52a2c148b641df2b4676ffe47c59f6388d58b99cdc424", size = 348170, upload-time = "2025-10-22T22:22:06.397Z" },
     { url = "https://files.pythonhosted.org/packages/18/ea/42d243d3a586beb72c77fa5def0487daf827210069a95f36328e869599ea/rpds_py-0.28.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e819e0e37a44a78e1383bf1970076e2ccc4dc8c2bbaa2f9bd1dc987e9afff628", size = 378838, upload-time = "2025-10-22T22:22:07.932Z" },
     { url = "https://files.pythonhosted.org/packages/e7/78/3de32e18a94791af8f33601402d9d4f39613136398658412a4e0b3047327/rpds_py-0.28.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5ee514e0f0523db5d3fb171f397c54875dbbd69760a414dccf9d4d7ad628b5bd", size = 393299, upload-time = "2025-10-22T22:22:09.435Z" },
-    { url = "https://files.pythonhosted.org/packages/13/7e/4bdb435afb18acea2eb8a25ad56b956f28de7c59f8a1d32827effa0d4514/rpds_py-0.28.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3fa06d27fdcee47f07a39e02862da0100cb4982508f5ead53ec533cd5fe55e", size = 518000, upload-time = "2025-10-22T22:22:11.326Z" },
+    { url = "https://files.pythonhosted.org/packages/13/7e/4bdb435afb18acea2eb8a25ad56b956f28de7c59f8a1d32827effa0d4514/rpds_py-0.28.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5f3fa06d27fdcee47f07a39e02862da0100cb4982508f5ead53ec533cd5fe55e", size = 518001, upload-time = "2025-10-22T22:22:11.326Z" },
     { url = "https://files.pythonhosted.org/packages/31/d0/5f52a656875cdc60498ab035a7a0ac8f399890cc1ee73ebd567bac4e39ae/rpds_py-0.28.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:46959ef2e64f9e4a41fc89aa20dbca2b85531f9a72c21099a3360f35d10b0d5a", size = 408746, upload-time = "2025-10-22T22:22:13.143Z" },
     { url = "https://files.pythonhosted.org/packages/3e/cd/49ce51767b879cde77e7ad9fae164ea15dce3616fe591d9ea1df51152706/rpds_py-0.28.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8455933b4bcd6e83fde3fefc987a023389c4b13f9a58c8d23e4b3f6d13f78c84", size = 386379, upload-time = "2025-10-22T22:22:14.602Z" },
     { url = "https://files.pythonhosted.org/packages/6a/99/e4e1e1ee93a98f72fc450e36c0e4d99c35370220e815288e3ecd2ec36a2a/rpds_py-0.28.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:ad50614a02c8c2962feebe6012b52f9802deec4263946cddea37aaf28dd25a66", size = 401280, upload-time = "2025-10-22T22:22:16.063Z" },
@@ -1537,7 +1541,7 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/89/8c/182a2a593195bfd39842ea68ebc084e20c850806117213f5a299dfc513d9/uvloop-0.22.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:561577354eb94200d75aca23fbde86ee11be36b00e52a4eaf8f50fb0c86b7705", size = 1358611, upload-time = "2025-10-16T22:16:36.833Z" },
     { url = "https://files.pythonhosted.org/packages/d2/14/e301ee96a6dc95224b6f1162cd3312f6d1217be3907b79173b06785f2fe7/uvloop-0.22.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:1cdf5192ab3e674ca26da2eada35b288d2fa49fdd0f357a19f0e7c4e7d5077c8", size = 751811, upload-time = "2025-10-16T22:16:38.275Z" },
     { url = "https://files.pythonhosted.org/packages/b7/02/654426ce265ac19e2980bfd9ea6590ca96a56f10c76e63801a2df01c0486/uvloop-0.22.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e2ea3d6190a2968f4a14a23019d3b16870dd2190cd69c8180f7c632d21de68d", size = 4288562, upload-time = "2025-10-16T22:16:39.375Z" },
-    { url = "https://files.pythonhosted.org/packages/15/c0/0be24758891ef825f2065cd5db8741aaddabe3e248ee6acc5e8a80f04005/uvloop-0.22.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0530a5fbad9c9e4ee3f2b33b148c6a64d47bbad8000ea63704fa8260f4cf728e", size = 4366890, upload-time = "2025-10-16T22:16:40.547Z" },
+    { url = "https://files.pythonhosted.org/packages/15/c0/0be24758891ef825f2065cd5db8741aaddabe3e248ee6acc5e8a80f04005/uvloop-0.22.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0530a5fbad9c9e4ee3f2b33b148c6a64d47bbad8001ea63704fa8260f4cf728e", size = 4366890, upload-time = "2025-10-16T22:16:40.547Z" },
     { url = "https://files.pythonhosted.org/packages/d2/53/8369e5219a5855869bcee5f4d317f6da0e2c669aecf0ef7d371e3d084449/uvloop-0.22.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:bc5ef13bbc10b5335792360623cc378d52d7e62c2de64660616478c32cd0598e", size = 4119472, upload-time = "2025-10-16T22:16:41.694Z" },
     { url = "https://files.pythonhosted.org/packages/f8/ba/d69adbe699b768f6b29a5eec7b47dd610bd17a69de51b251126a801369ea/uvloop-0.22.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1f38ec5e3f18c8a10ded09742f7fb8de0108796eb673f30ce7762ce1b8550cad", size = 4239051, upload-time = "2025-10-16T22:16:43.224Z" },
     { url = "https://files.pythonhosted.org/packages/90/cd/b62bdeaa429758aee8de8b00ac0dd26593a9de93d302bff3d21439e9791d/uvloop-0.22.1-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:3879b88423ec7e97cd4eba2a443aa26ed4e59b45e6b76aabf13fe2f27023a142", size = 1362067, upload-time = "2025-10-16T22:16:44.503Z" },

debug_endpoints.py

@@ -0,0 +1,169 @@
+#!/usr/bin/env python3
+"""Debug script to check which endpoints are working."""
+
+import requests
+import json
+from urllib.parse import urljoin
+
+
+def test_endpoint(url, method="GET", headers=None, data=None, timeout=5):
+    """Test a single endpoint and return detailed results."""
+    try:
+        if method.upper() == "GET":
+            response = requests.get(url, headers=headers, timeout=timeout)
+        elif method.upper() == "POST":
+            response = requests.post(url, headers=headers, json=data, timeout=timeout)
+
+        return {
+            "status": "SUCCESS",
+            "status_code": response.status_code,
+            "response": response.text[:500],  # Limit response length
+            "headers": dict(response.headers),
+        }
+    except requests.exceptions.ConnectionError:
+        return {"status": "CONNECTION_ERROR", "error": "Cannot connect to server"}
+    except requests.exceptions.Timeout:
+        return {"status": "TIMEOUT", "error": "Request timed out"}
+    except Exception as e:
+        return {"status": "ERROR", "error": str(e)}
+
+
+def check_all_endpoints():
+    """Check all possible endpoints systematically."""
+
+    print("🔍 Debugging Endpoint Availability")
+    print("=" * 60)
+
+    # Define test cases
+    test_cases = [
+        # FastAPI Server (Port 8000)
+        {
+            "name": "FastAPI Health",
+            "url": "http://localhost:8000/health",
+            "method": "GET",
+        },
+        {"name": "FastAPI Root", "url": "http://localhost:8000/", "method": "GET"},
+        {
+            "name": "FastAPI API Root",
+            "url": "http://localhost:8000/api/",
+            "method": "GET",
+        },
+        # MCP Server (Port 8001)
+        {"name": "MCP Root", "url": "http://localhost:8001/", "method": "GET"},
+        {"name": "MCP Endpoint", "url": "http://localhost:8001/mcp", "method": "GET"},
+        {
+            "name": "MCP Health (if exists)",
+            "url": "http://localhost:8001/health",
+            "method": "GET",
+        },
+        # MCP Protocol Tests
+        {
+            "name": "MCP Initialize",
+            "url": "http://localhost:8001/mcp",
+            "method": "POST",
+            "headers": {
+                "Authorization": "Bearer local-dev-token",
+                "Content-Type": "application/json",
+                "Accept": "application/json, text/event-stream",
+            },
+            "data": {
+                "jsonrpc": "2.0",
+                "id": 1,
+                "method": "initialize",
+                "params": {
+                    "protocolVersion": "2024-11-05",
+                    "capabilities": {},
+                    "clientInfo": {"name": "debug-client", "version": "1.0.0"},
+                },
+            },
+        },
+        {
+            "name": "MCP Tools List",
+            "url": "http://localhost:8001/mcp",
+            "method": "POST",
+            "headers": {
+                "Authorization": "Bearer local-dev-token",
+                "Content-Type": "application/json",
+                "Accept": "application/json, text/event-stream",
+            },
+            "data": {"jsonrpc": "2.0", "id": 2, "method": "tools/list"},
+        },
+    ]
+
+    results = {}
+
+    for test in test_cases:
+        print(f"\n🧪 Testing: {test['name']}")
+        print(f"   URL: {test['url']}")
+        print(f"   Method: {test['method']}")
+
+        result = test_endpoint(
+            url=test["url"],
+            method=test["method"],
+            headers=test.get("headers"),
+            data=test.get("data"),
+        )
+
+        results[test["name"]] = result
+
+        if result["status"] == "SUCCESS":
+            print(f"   ✅ Status: {result['status_code']}")
+            if result["response"]:
+                # Try to pretty print JSON
+                try:
+                    json_resp = json.loads(result["response"])
+                    print(f"   📄 Response: {json.dumps(json_resp, indent=2)[:200]}...")
+                except:
+                    print(f"   📄 Response: {result['response'][:100]}...")
+        else:
+            print(f"   ❌ {result['status']}: {result.get('error', 'Unknown error')}")
+
+    print("\n" + "=" * 60)
+    print("📊 SUMMARY")
+    print("=" * 60)
+
+    working = []
+    not_working = []
+
+    for name, result in results.items():
+        if result["status"] == "SUCCESS" and result.get("status_code", 0) < 400:
+            working.append(name)
+        else:
+            not_working.append(name)
+
+    print(f"\n✅ WORKING ({len(working)}):")
+    for name in working:
+        status_code = results[name].get("status_code", "N/A")
+        print(f"   - {name} (HTTP {status_code})")
+
+    print(f"\n❌ NOT WORKING ({len(not_working)}):")
+    for name in not_working:
+        result = results[name]
+        if result["status"] == "SUCCESS":
+            print(f"   - {name} (HTTP {result.get('status_code', 'N/A')})")
+        else:
+            print(f"   - {name} ({result['status']})")
+
+    print(f"\n🔧 RECOMMENDATIONS:")
+
+    # Check if any server is running
+    fastapi_working = any("FastAPI" in name for name in working)
+    mcp_working = any("MCP" in name for name in working)
+
+    if not fastapi_working:
+        print("   - Start FastAPI server: cd backend && python main.py")
+
+    if not mcp_working:
+        print(
+            "   - Start MCP server: cd backend && MCP_TRANSPORT=http MCP_PORT=8001 python -m src.mcp.server"
+        )
+
+    if not working:
+        print("   - Check if any servers are running: netstat -ano | findstr :8000")
+        print("   - Check if any servers are running: netstat -ano | findstr :8001")
+
+    return results
+
+
+if __name__ == "__main__":
+    check_all_endpoints()

frontend/package-lock.json

@@ -118,7 +118,6 @@
       "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@babel/code-frame": "^7.27.1",
         "@babel/generator": "^7.28.5",
@@ -710,7 +709,6 @@
       "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -1736,7 +1734,6 @@
       "integrity": "sha512-2I0gnIVPtfnMw9ee9h1dJG7tp81+8Ob3OJb3Mv37rx5L40/b0i7djjCVvGOVqc9AEIQyvyu1i6ypKdFw8R8gQw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": "^14.21.3 || >=16"
       },
@@ -3324,7 +3321,6 @@
       "integrity": "sha512-GNWcUTRBgIRJD5zj+Tq0fKOJ5XZajIiBroOF0yvj2bSU1WvNdYS/dn9UxwsujGW4JX06dnHyjV2y9rRaybH0iQ==",
       "devOptional": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "undici-types": "~7.16.0"
       }
@@ -3334,7 +3330,6 @@
       "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.5.tgz",
       "integrity": "sha512-keKxkZMqnDicuvFoJbzrhbtdLSPhj/rZThDlKWCDbgXmUg0rEUFtRssDXKYmtXluZlIqiC5VqkCgRwzuyLHKHw==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "csstype": "^3.0.2"
       }
@@ -3345,7 +3340,6 @@
       "integrity": "sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==",
       "devOptional": true,
       "license": "MIT",
-      "peer": true,
       "peerDependencies": {
         "@types/react": "^19.2.0"
       }
@@ -3409,7 +3403,6 @@
       "integrity": "sha512-tK3GPFWbirvNgsNKto+UmB/cRtn6TZfyw0D6IKrW55n6Vbs7KJoZtI//kpTKzE/DUmmnAFD8/Ca46s7Obs92/w==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@typescript-eslint/scope-manager": "8.46.4",
         "@typescript-eslint/types": "8.46.4",
@@ -3682,7 +3675,6 @@
       "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -4003,7 +3995,6 @@
         }
       ],
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "baseline-browser-mapping": "^2.8.25",
         "caniuse-lite": "^1.0.30001754",
@@ -4878,7 +4869,6 @@
       "integrity": "sha512-BhHmn2yNOFA9H9JmmIVKJmd288g9hrVRDkdoIgRCRuSySRUHH7r/DI6aAXW9T1WwUuY3DFgrcaqB+deURBLR5g==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.8.0",
         "@eslint-community/regexpp": "^4.12.1",
@@ -5147,7 +5137,6 @@
       "integrity": "sha512-DT9ck5YIRU+8GYzzU5kT3eHGA5iL+1Zd0EutOmTE9Dtk+Tvuzd23VBU+ec7HPNSTxXYO55gPV/hq4pSBJDjFpA==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "accepts": "^2.0.0",
         "body-parser": "^2.2.0",
@@ -5630,9 +5619,9 @@
       }
     },
     "node_modules/glob": {
-      "version": "10.4.5",
-      "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz",
-      "integrity": "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==",
+      "version": "10.5.0",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-10.5.0.tgz",
+      "integrity": "sha512-DfXN8DfhJ7NH3Oe7cFmu3NCu1wKbkReJ8TorzSAFbSKrlNaQSKfIzqYqVY8zlbs2NLBbWpRiU52GX2PbaBVNkg==",
       "license": "ISC",
       "dependencies": {
         "foreground-child": "^3.1.0",
@@ -6202,7 +6191,6 @@
       "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.7.tgz",
       "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
       "license": "MIT",
-      "peer": true,
       "bin": {
         "jiti": "bin/jiti.js"
       }
@@ -8043,7 +8031,6 @@
         }
       ],
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "nanoid": "^3.3.11",
         "picocolors": "^1.1.1",
@@ -8355,7 +8342,6 @@
       "resolved": "https://registry.npmjs.org/react/-/react-19.2.0.tgz",
       "integrity": "sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=0.10.0"
       }
@@ -8365,7 +8351,6 @@
       "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.0.tgz",
       "integrity": "sha512-UlbRu4cAiGaIewkPyiRGJk0imDN2T3JjieT6spoL2UeSf5od4n5LB/mQ4ejmxhCFT1tYe8IvaFulzynWovsEFQ==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "scheduler": "^0.27.0"
       },
@@ -9408,7 +9393,6 @@
       "resolved": "https://registry.npmjs.org/tailwindcss/-/tailwindcss-3.4.17.tgz",
       "integrity": "sha512-w33E2aCvSDP0tW9RZuNXadXlkHXqFzSkQew/aIa2i/Sj8fThxwovwlXHSPXTbAHwEIhBFXAedUhP2tueAKP8Og==",
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@alloc/quick-lru": "^5.2.0",
         "arg": "^5.0.2",
@@ -9540,7 +9524,6 @@
       "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
       "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -9720,7 +9703,6 @@
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
       "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
       "license": "Apache-2.0",
-      "peer": true,
       "bin": {
         "tsc": "bin/tsc",
         "tsserver": "bin/tsserver"
@@ -10123,7 +10105,6 @@
       "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
       "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -10314,7 +10295,6 @@
       "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.1.tgz",
       "integrity": "sha512-lcYcMxX2PO9XMGvAJkJ3OsNMw+/7FKes7/hgerGUYWIoWu5j/+YQqcZr5JnPZWzOsEBgMbSbiSTn/dv/69Mkpw==",
       "license": "ISC",
-      "peer": true,
       "bin": {
         "yaml": "bin.mjs"
       },
@@ -10441,7 +10421,6 @@
       "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "funding": {
         "url": "https://github.com/sponsors/colinhacks"
       }

frontend/vite.config.ts

@@ -13,7 +13,7 @@ export default defineConfig({
   server: {
     proxy: {
       '/api': {
-        target: 'http://localhost:8000',
+        target: 'http://localhost:8001',
         changeOrigin: true,
       },
     },

mcp_init_request.json

@@ -0,0 +1,14 @@
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "initialize",
+  "params": {
+    "protocolVersion": "2024-11-05",
+    "capabilities": {},
+    "clientInfo": {
+      "name": "test-client",
+      "version": "1.0.0"
+    }
+  }
+}
+

start-dev.sh

@@ -37,12 +37,12 @@ echo -e "${GREEN}Starting backend server...${NC}"
 cd "$BACKEND_DIR"
 JWT_SECRET_KEY="local-dev-secret-key-123" \
 VAULT_BASE_PATH="$PROJECT_ROOT/data/vaults" \
-.venv/bin/uvicorn src.api.main:app --host 0.0.0.0 --port 8000 --reload > "$PROJECT_ROOT/backend.log" 2>&1 &
+.venv/bin/uvicorn src.api.main:app --host 0.0.0.0 --port 8001 --reload > "$PROJECT_ROOT/backend.log" 2>&1 &
 BACKEND_PID=$!
 echo $BACKEND_PID > "$BACKEND_PID_FILE"
 echo -e "${GREEN}✓ Backend started (PID: $BACKEND_PID)${NC}"
 echo "  Logs: $PROJECT_ROOT/backend.log"
-echo "  URL: http://localhost:8000"
+echo "  URL: http://localhost:8001"
 
 # Wait a moment for backend to start
 sleep 2
@@ -63,7 +63,7 @@ echo "Development servers are running!"
 echo "=================================================="
 echo -e "${NC}"
 echo "Frontend: http://localhost:5173"
-echo "Backend:  http://localhost:8000"
+echo "Backend:  http://localhost:8001"
 echo ""
 echo "To stop servers, run: ./stop-dev.sh"
 echo "To view logs, run: tail -f backend.log frontend.log"

status-dev.sh

@@ -19,7 +19,7 @@ if [ -f "$BACKEND_PID_FILE" ]; then
     BACKEND_PID=$(cat "$BACKEND_PID_FILE")
     if ps -p $BACKEND_PID > /dev/null 2>&1; then
         echo -e "${GREEN}✓ Backend: RUNNING${NC} (PID: $BACKEND_PID)"
-        echo "  URL: http://localhost:8000"
+        echo "  URL: http://localhost:8001"
     else
         echo -e "${RED}✗ Backend: NOT RUNNING${NC} (stale PID: $BACKEND_PID)"
     fi