feat: add optional api_url configuration for remote API connection

- Add api_url field to BasicMemoryConfig for connecting to remote Basic Memory APIs
- Refactor async_client.py to conditionally create HTTP or ASGI transport based on config
- Add logging for client creation (info for remote, debug for local)
- Add basic test coverage for both local ASGI and remote HTTP client creation
- When api_url is set, MCP tools will connect to remote API instead of local ASGI transport

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: phernandez

src/basic_memory/config.py

@@ -74,6 +74,12 @@ class BasicMemoryConfig(BaseSettings):
         description="Whether to sync changes in real time. default (True)",
     )
 
+    # API connection configuration
+    api_url: Optional[str] = Field(
+        default=None,
+        description="URL of remote Basic Memory API. If set, MCP will connect to this API instead of using local ASGI transport.",
+    )
+
     model_config = SettingsConfigDict(
         env_prefix="BASIC_MEMORY_",
         extra="ignore",

src/basic_memory/mcp/async_client.py

@@ -1,8 +1,29 @@
 from httpx import ASGITransport, AsyncClient
+from loguru import logger
 
 from basic_memory.api.app import app as fastapi_app
+from basic_memory.config import ConfigManager
 
-BASE_URL = "http://test"
+def create_client() -> AsyncClient:
+    """Create an HTTP client based on configuration.
+    
+    Returns:
+        AsyncClient configured for either local ASGI or remote HTTP transport
+    """
+    config_manager = ConfigManager()
+    config = config_manager.load_config()
+    
+    if config.api_url:
+        # Use HTTP transport for remote API
+        logger.info(f"Creating HTTP client for remote Basic Memory API: {config.api_url}")
+        return AsyncClient(base_url=config.api_url)
+    else:
+        # Use ASGI transport for local API
+        logger.debug("Creating ASGI client for local Basic Memory API")
+        return AsyncClient(
+            transport=ASGITransport(app=fastapi_app), 
+            base_url="http://test"
+        )
 
 # Create shared async client
-client = AsyncClient(transport=ASGITransport(app=fastapi_app), base_url=BASE_URL)
+client = create_client()

tests/api/test_async_client.py

@@ -0,0 +1,37 @@
+"""Tests for async_client configuration."""
+
+import pytest
+from unittest.mock import patch
+from httpx import AsyncClient, ASGITransport
+
+from basic_memory.mcp.async_client import create_client
+from basic_memory.config import BasicMemoryConfig
+
+
+def test_create_client_uses_asgi_when_no_api_url():
+    """Test that create_client uses ASGI transport when api_url is None."""
+    mock_config = BasicMemoryConfig(api_url=None)
+    
+    with patch('basic_memory.mcp.async_client.ConfigManager') as mock_config_manager:
+        mock_config_manager.return_value.load_config.return_value = mock_config
+        
+        client = create_client()
+        
+        assert isinstance(client, AsyncClient)
+        assert isinstance(client._transport, ASGITransport)
+        assert str(client.base_url) == "http://test"
+
+
+def test_create_client_uses_http_when_api_url_set():
+    """Test that create_client uses HTTP transport when api_url is configured."""
+    remote_url = "https://api.basicmemory.example.com"
+    mock_config = BasicMemoryConfig(api_url=remote_url)
+    
+    with patch('basic_memory.mcp.async_client.ConfigManager') as mock_config_manager:
+        mock_config_manager.return_value.load_config.return_value = mock_config
+        
+        client = create_client()
+        
+        assert isinstance(client, AsyncClient)
+        assert not isinstance(client._transport, ASGITransport)
+        assert str(client.base_url) == remote_url