import asyncio
from fastmcp import Client
from mcp_server.app import create_app
from mcp_server.config import AppConfig
from mcp_server.interfaces.mcp.server import mcp

config = AppConfig(gemini_api_key="fake")  # mock-gemini auto-fallback
create_app(config)

async def main():
    async with Client(mcp) as client:
        # List projects
        for p in (await client.call_tool("list_projects", {})).data:
            print(f"{p['id']}: {p['index_chunk_count']} chunks")

        # Search code semantically
        r = (await client.call_tool("search_code",
               {"query": "async error handling"})).data
        for c in r[:3]:
            print(f"  {c['file_path']}: {c['content'][:60]}")

        # Read architecture docs
        r = (await client.call_tool("explain_architecture",
               {"project_id": "finance-coach-latam"})).data
        print(f"  Architecture summary: {r['summary'][:200]}")

asyncio.run(main())

                     ┌─────────────────────────────────────────────┐
                     │  INTERFACES (FastMCP tools @ /mcp)            │
                     │  └── uses application/use_cases (hexagonal)  │
                     ├─────────────────────────────────────────────┤
                     │  APPLICATION (use cases + ports)             │
                     │  use cases depend on ports (Protocols)       │
                     │  ports are abstract interfaces               │
                     ├─────────────────────────────────────────────┤
                     │  DOMAIN (pure Python, no framework deps)     │
                     │  entities (CodeChunk, Project, ...)         │
                     │  value objects (ChunkHash, Vector, ...)     │
                     │  exceptions (DomainError, ...)              │
                     └─────────────────────────────────────────────┘
                              ▲
                              │ implements
                     ┌─────────────────────────────────────────────┐
                     │  INFRASTRUCTURE (adapters)                   │
                     │  ONE file: src/mcp_server/infrastructure/  │
                     │             langchain.py                     │
                     │  (chunking + agent + embedding)             │
                     └─────────────────────────────────────────────┘

# 1. Clone and install
git clone https://github.com/lodeharri/portfolio-mcp-server.git
cd portfolio-mcp-server
pip install -e ".[dev]"

# 2. Set up environment
cp .env.example .env
# Edit .env — leave GEMINI_API_KEY empty for mock mode (zero tokens)

# 3. Preindex (uses mock-gemini if no key)
python -m mcp_server.interfaces.cli.preindex --mock-gemini --quiet

# 4. Run the MCP server
python -c "from mcp_server.app import create_app; from mcp_server.config import AppConfig; create_app(AppConfig())"
# Or in a Docker container:
docker run --rm -d -p 8080:8080 --name mcp mcp-server:test

# 5. Test with the FastMCP client
python -c "
import asyncio
from fastmcp import Client
from mcp_server.app import create_app
from mcp_server.config import AppConfig
from mcp_server.interfaces.mcp.server import mcp

create_app(AppConfig())

async def main():
    async with Client(mcp) as client:
        for p in (await client.call_tool('list_projects', {})).data:
            print(f\"{p['id']}: {p['index_chunk_count']} chunks\")

asyncio.run(main())
"

# Skip the index.sqlite for a fresh build
rm data/index.sqlite

# Preindex with your real API key (prod mode)
python -m mcp_server.interfaces.cli.preindex --manifest config/projects.manifest.yaml

# With --purge-orphans to delete chunks whose source files no longer exist
python -m mcp_server.interfaces.cli.preindex --purge-orphans

# Run all tests
pytest -q
# → 479 passed, 2 skipped (Docker image size tests)

# Run ruff
ruff check src/mcp_server tests/

# Run a specific test suite
pytest tests/integration/test_mcp_tools_ask_portfolio.py -v

import asyncio
from mcp_server.app import create_app
from mcp_server.config import AppConfig
from fastmcp import Client
from mcp_server.interfaces.mcp.server import mcp
create_app(AppConfig(gemini_api_key="fake"))
async def main():
    async with Client(mcp) as client:
        await client.call_tool("ask_portfolio", {"question": "test"})
asyncio.run(main())
# → ToolError: Function must have a docstring if description not provided.

portfolio-mcp-server/
├── README.md                                   # You are here
├── pyproject.toml                              # LangChain + pydantic-ai-slim + google-genai
├── Dockerfile                                  # Multi-stage, 417 MB
├── fly.toml                                    # Fly.io config
├── .env.example                                # Template for local dev
├── .github/workflows/                          # test, lint, secret-scan, deploy
├── config/
│   └── projects.manifest.yaml                  # Source of truth for indexing
├── src/mcp_server/
│   ├── app.py                                  # create_app() factory
│   ├── config.py                               # AppConfig, the only os.environ reader
│   ├── composition.py                          # DI container
│   ├── domain/                                 # Pure entities + value objects
│   ├── application/
│   │   ├── ports/                              # Abstract interfaces
│   │   └── use_cases/                          # Application services
│   ├── infrastructure/
│   │   ├── langchain.py                        # SINGLE FILE — LangChain wiring
│   │   ├── adapters/                           # Concrete implementations
│   │   ├── db/                                 # SQLite + schema
│   │   └── security/                           # 5-layer security
│   └── interfaces/
│       ├── mcp/                                # FastMCP tools + registrations
│       ├── http/                               # Healthz + middleware
│       └── cli/                                # preindex CLI
├── scripts/
│   └── bake_schema.py                          # Schema-only DB for Docker build
├── tests/
│   ├── conftest.py
│   ├── unit/
│   └── integration/
├── data/
│   └── index.sqlite                            # Generated, gitignored
└── openspec/
    ├── config.yaml
    ├── specs/                                  # Main capability specs
    └── changes/
        └── archive/
            ├── 2026-08-05-001-bootstrap/
            └── 2026-08-05-002-mcp-tools/