gfp-mcp 0.2.4__tar.gz → 0.3.3__tar.gz

{gfp_mcp-0.2.4 → gfp_mcp-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gfp-mcp
-Version: 0.2.4
+Version: 0.3.3
 Summary: Model Context Protocol (MCP) server for GDSFactory+ photonic IC design
 Author: GDSFactory+ Team
 License: MIT
@@ -27,7 +27,10 @@ License-File: LICENSE
 Requires-Dist: mcp>=1.7.1
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: typing-extensions>=4.0.0; python_version < "3.11"
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
 Requires-Dist: psutil>=5.9.0
+Provides-Extra: render
+Requires-Dist: klayout>=0.28.0; extra == "render"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -41,7 +44,6 @@ Dynamic: license-file
 
 [![PyPI version](https://img.shields.io/pypi/v/gfp-mcp.svg)](https://pypi.org/project/gfp-mcp/)
 [![Python versions](https://img.shields.io/pypi/pyversions/gfp-mcp.svg)](https://pypi.org/project/gfp-mcp/)
-[![Tests](https://github.com/doplaydo/gfp-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/doplaydo/gfp-mcp/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Model Context Protocol (MCP) server for GDSFactory+ that enables AI assistants like Claude to design and build photonic integrated circuits.
@@ -50,88 +52,71 @@ Model Context Protocol (MCP) server for GDSFactory+ that enables AI assistants l
 
 This MCP server connects AI assistants to [GDSFactory+](https://gdsfactory.com), allowing you to design photonic ICs through natural language. Build components, run verification checks, and manage multiple projects directly from Claude Code or Claude Desktop.
 
-## Quick Start
-
-### 1. Install Prerequisites
+## Prerequisites
 
 - Python 3.10 or higher
 - VSCode with the [GDSFactory+ extension](https://marketplace.visualstudio.com/items?itemName=gdsfactory.gdsfactoryplus) installed
 
-### 2. Install the MCP Server
+## Installation
 
-**With uv (recommended):**
+Choose your AI assistant below and follow the instructions.
 
-If you don't have `uv` installed, see the [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/).
+### 1. Cursor
 
-```bash
-uv tool install gfp-mcp
-```
+**One-click install:**
 
-<details>
-<summary>Ephemeral approach</summary>
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=gdsfactoryplus&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnZnAtbWNwIiwiZ2ZwLW1jcC1zZXJ2ZSJdfQ%3D%3D)
 
-Run without installing:
+**Manual setup:**
 
-```bash
-uvx --from gfp-mcp gfp-mcp-serve
-```
-</details>
-
-<details>
-<summary><strong>Alternative: pip install</strong></summary>
+Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` for global access):
 
-```bash
-pip install gfp-mcp
+```json
+{
+    "mcpServers": {
+        "gdsfactoryplus": {
+            "command": "uvx",
+            "args": ["--from", "gfp-mcp", "gfp-mcp-serve"]
+        }
+    }
+}
 ```
 
-</details>
+### 2. Claude Code
 
-### 3. Connect to Your AI Assistant
+Run the following command:
 
-<details>
-<summary><strong>Claude Code</strong></summary>
+```bash
+claude mcp add gdsfactoryplus -- uvx --from gfp-mcp gfp-mcp-serve
+```
 
-Add to `.claude/settings.json`:
+Or add to `.claude/settings.json` manually:
 
 ```json
 {
     "mcpServers": {
         "gdsfactoryplus": {
-            "command": "gfp-mcp-serve",
-            "args": [],
-            "env": {
-                "GFP_API_URL": "http://localhost:8787"
-            }
+            "command": "uvx",
+            "args": ["--from", "gfp-mcp", "gfp-mcp-serve"]
         }
     }
 }
 ```
 
-Or use the CLI:
-
-```bash
-claude mcp add gdsfactoryplus -- gfp-mcp-serve
-```
-
-</details>
-
-<details>
-<summary><strong>Claude Desktop</strong></summary>
+### 3. Claude Desktop
 
 Add to your config file:
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-
-**Linux**: `~/.config/Claude/claude_desktop_config.json`
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/Claude/claude_desktop_config.json`
 
 ```json
 {
     "mcpServers": {
         "gdsfactoryplus": {
-            "command": "gfp-mcp-serve",
-            "args": []
+            "command": "uvx",
+            "args": ["--from", "gfp-mcp", "gfp-mcp-serve"]
         }
     }
 }
@@ -139,16 +124,21 @@ Add to your config file:
 
 Restart Claude Desktop after adding the configuration.
 
-</details>
+### 4. Other MCP Clients
 
-<details>
-<summary><strong>Cursor</strong></summary>
+Install `gfp-mcp` and run the server:
+
+```bash
+uvx --from gfp-mcp gfp-mcp-serve
+```
 
-Coming soon. Follow the MCP integration instructions for Cursor when available.
+Or install globally first, then reference `gfp-mcp-serve` in your client's MCP configuration:
 
-</details>
+```bash
+uv tool install gfp-mcp
+```
 
-### 4. Start Designing
+## Start Designing
 
 The MCP server automatically discovers running GDSFactory+ servers via the registry (`~/.gdsfactory/server-registry.json`). On startup, it will log all discovered projects.
 
@@ -162,14 +152,19 @@ Try these commands with your AI assistant:
 
 ## Available Tools
 
-- **build_cells** - Build one or more GDS cells by name (pass a list, can be single-item)
-- **list_cells** - List all available photonic components
-- **get_cell_info** - Get detailed component metadata
-- **list_projects** - List all running GDSFactory+ server instances
-- **get_project_info** - Get detailed information about a specific project
-- **check_drc** - Run Design Rule Check verification (returns structured format with all violations including simplified location data for LLM-friendly troubleshooting)
-- **check_connectivity** - Run connectivity verification
-- **check_lvs** - Run Layout vs. Schematic verification
+| Tool | Description |
+|------|-------------|
+| **list_projects** | List all running GDSFactory+ server instances |
+| **get_project_info** | Get detailed information about a specific project |
+| **build_cells** | Build one or more GDS cells by name (pass a list, can be single-item) |
+| **list_cells** | List all available photonic components |
+| **get_cell_info** | Get detailed component metadata |
+| **check_drc** | Run Design Rule Check verification with structured violation reports |
+| **check_connectivity** | Run connectivity verification |
+| **check_lvs** | Run Layout vs. Schematic verification |
+| **simulate_component** | Run SAX circuit simulations with custom parameters |
+| **list_samples** | List available sample files from GDSFactory+ General PDK projects |
+| **get_sample_file** | Get the content of a specific sample file from a project |
 
 ## Multi-Project Support
 

{gfp_mcp-0.2.4 → gfp_mcp-0.3.3}/README.md

@@ -2,7 +2,6 @@
 
 [![PyPI version](https://img.shields.io/pypi/v/gfp-mcp.svg)](https://pypi.org/project/gfp-mcp/)
 [![Python versions](https://img.shields.io/pypi/pyversions/gfp-mcp.svg)](https://pypi.org/project/gfp-mcp/)
-[![Tests](https://github.com/doplaydo/gfp-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/doplaydo/gfp-mcp/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Model Context Protocol (MCP) server for GDSFactory+ that enables AI assistants like Claude to design and build photonic integrated circuits.
@@ -11,88 +10,71 @@ Model Context Protocol (MCP) server for GDSFactory+ that enables AI assistants l
 
 This MCP server connects AI assistants to [GDSFactory+](https://gdsfactory.com), allowing you to design photonic ICs through natural language. Build components, run verification checks, and manage multiple projects directly from Claude Code or Claude Desktop.
 
-## Quick Start
-
-### 1. Install Prerequisites
+## Prerequisites
 
 - Python 3.10 or higher
 - VSCode with the [GDSFactory+ extension](https://marketplace.visualstudio.com/items?itemName=gdsfactory.gdsfactoryplus) installed
 
-### 2. Install the MCP Server
+## Installation
 
-**With uv (recommended):**
+Choose your AI assistant below and follow the instructions.
 
-If you don't have `uv` installed, see the [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/).
+### 1. Cursor
 
-```bash
-uv tool install gfp-mcp
-```
+**One-click install:**
 
-<details>
-<summary>Ephemeral approach</summary>
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=gdsfactoryplus&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnZnAtbWNwIiwiZ2ZwLW1jcC1zZXJ2ZSJdfQ%3D%3D)
 
-Run without installing:
+**Manual setup:**
 
-```bash
-uvx --from gfp-mcp gfp-mcp-serve
-```
-</details>
-
-<details>
-<summary><strong>Alternative: pip install</strong></summary>
+Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` for global access):
 
-```bash
-pip install gfp-mcp
+```json
+{
+    "mcpServers": {
+        "gdsfactoryplus": {
+            "command": "uvx",
+            "args": ["--from", "gfp-mcp", "gfp-mcp-serve"]
+        }
+    }
+}
 ```
 
-</details>
+### 2. Claude Code
 
-### 3. Connect to Your AI Assistant
+Run the following command:
 
-<details>
-<summary><strong>Claude Code</strong></summary>
+```bash
+claude mcp add gdsfactoryplus -- uvx --from gfp-mcp gfp-mcp-serve
+```
 
-Add to `.claude/settings.json`:
+Or add to `.claude/settings.json` manually:
 
 ```json
 {
     "mcpServers": {
         "gdsfactoryplus": {
-            "command": "gfp-mcp-serve",
-            "args": [],
-            "env": {
-                "GFP_API_URL": "http://localhost:8787"
-            }
+            "command": "uvx",
+            "args": ["--from", "gfp-mcp", "gfp-mcp-serve"]
         }
     }
 }
 ```
 
-Or use the CLI:
-
-```bash
-claude mcp add gdsfactoryplus -- gfp-mcp-serve
-```
-
-</details>
-
-<details>
-<summary><strong>Claude Desktop</strong></summary>
+### 3. Claude Desktop
 
 Add to your config file:
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-
-**Linux**: `~/.config/Claude/claude_desktop_config.json`
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **Linux**: `~/.config/Claude/claude_desktop_config.json`
 
 ```json
 {
     "mcpServers": {
         "gdsfactoryplus": {
-            "command": "gfp-mcp-serve",
-            "args": []
+            "command": "uvx",
+            "args": ["--from", "gfp-mcp", "gfp-mcp-serve"]
         }
     }
 }
@@ -100,16 +82,21 @@ Add to your config file:
 
 Restart Claude Desktop after adding the configuration.
 
-</details>
+### 4. Other MCP Clients
 
-<details>
-<summary><strong>Cursor</strong></summary>
+Install `gfp-mcp` and run the server:
+
+```bash
+uvx --from gfp-mcp gfp-mcp-serve
+```
 
-Coming soon. Follow the MCP integration instructions for Cursor when available.
+Or install globally first, then reference `gfp-mcp-serve` in your client's MCP configuration:
 
-</details>
+```bash
+uv tool install gfp-mcp
+```
 
-### 4. Start Designing
+## Start Designing
 
 The MCP server automatically discovers running GDSFactory+ servers via the registry (`~/.gdsfactory/server-registry.json`). On startup, it will log all discovered projects.
 
@@ -123,14 +110,19 @@ Try these commands with your AI assistant:
 
 ## Available Tools
 
-- **build_cells** - Build one or more GDS cells by name (pass a list, can be single-item)
-- **list_cells** - List all available photonic components
-- **get_cell_info** - Get detailed component metadata
-- **list_projects** - List all running GDSFactory+ server instances
-- **get_project_info** - Get detailed information about a specific project
-- **check_drc** - Run Design Rule Check verification (returns structured format with all violations including simplified location data for LLM-friendly troubleshooting)
-- **check_connectivity** - Run connectivity verification
-- **check_lvs** - Run Layout vs. Schematic verification
+| Tool | Description |
+|------|-------------|
+| **list_projects** | List all running GDSFactory+ server instances |
+| **get_project_info** | Get detailed information about a specific project |
+| **build_cells** | Build one or more GDS cells by name (pass a list, can be single-item) |
+| **list_cells** | List all available photonic components |
+| **get_cell_info** | Get detailed component metadata |
+| **check_drc** | Run Design Rule Check verification with structured violation reports |
+| **check_connectivity** | Run connectivity verification |
+| **check_lvs** | Run Layout vs. Schematic verification |
+| **simulate_component** | Run SAX circuit simulations with custom parameters |
+| **list_samples** | List available sample files from GDSFactory+ General PDK projects |
+| **get_sample_file** | Get the content of a specific sample file from a project |
 
 ## Multi-Project Support
 

{gfp_mcp-0.2.4/mcp_standalone → gfp_mcp-0.3.3/gfp_mcp}/__init__.py

@@ -1,22 +1,22 @@
-"""MCP Standalone Server for GDSFactory+.
+"""GDSFactory+ MCP Server.
 
 This package provides a Model Context Protocol (MCP) server that exposes
 GDSFactory+ operations as tools for AI assistants. The server uses STDIO
 transport and proxies requests to the FastAPI backend.
 
 Architecture:
-- Standalone MCP server (this package)
+- Tool handlers in gfp_mcp/tools/ with co-located definitions and transformers
 - STDIO transport for universal compatibility
-- HTTP proxy to FastAPI backend
+- HTTP proxy to FastAPI backend via client.py
+- Multi-project routing via server registry
 - Zero changes to existing FastAPI server
-- No database conflicts (only FastAPI touches SQLite)
 
 Usage:
-    from gdsfactoryplus.mcp_standalone import main
+    from gfp_mcp import main
     main()
 
 Or via CLI:
-    gfp mcp-serve
+    gfp-mcp-serve
 """
 
 from __future__ import annotations
@@ -25,18 +25,20 @@ from .client import FastAPIClient
 from .config import MCPConfig
 from .resources import get_all_resources, get_resource_content
 from .server import create_server, main, run_server
-from .tools import get_all_tools, get_tool_by_name
+from .tools import get_all_tools, get_handler, get_tool_by_name
 
 __all__ = [
+    "__version__",
     "FastAPIClient",
     "MCPConfig",
     "create_server",
     "main",
     "run_server",
     "get_all_tools",
+    "get_handler",
     "get_tool_by_name",
     "get_all_resources",
     "get_resource_content",
 ]
 
-__version__ = "0.2.4"
+__version__ = "0.3.3"

{gfp_mcp-0.2.4/mcp_standalone → gfp_mcp-0.3.3/gfp_mcp}/client.py

@@ -294,17 +294,3 @@ class FastAPIClient:
             }
             for server in servers
         ]
-
-    async def get_project_info(self, project: str) -> dict[str, Any]:
-        """Get detailed information about a specific project.
-
-        Args:
-            project: Project name or path
-
-        Returns:
-            Project information from the server's /info endpoint
-
-        Raises:
-            ValueError: If project not found
-        """
-        return await self.request("GET", "/info", project=project)

gfp_mcp-0.3.3/gfp_mcp/config.py

@@ -0,0 +1,161 @@
+"""Configuration management for MCP standalone server."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Final
+
+try:
+    import tomllib  # Python 3.11+
+except ImportError:
+    import tomli as tomllib  # type: ignore[import-not-found]
+
+__all__ = ["MCPConfig", "get_gfp_api_key", "set_gfp_api_key"]
+
+
+class MCPConfig:
+    """Configuration for MCP standalone server.
+
+    Manages environment variables and default settings for the MCP server
+    that proxies requests to the FastAPI backend.
+    """
+
+    API_URL: Final[str | None] = os.getenv("GFP_API_URL")
+
+    TIMEOUT: Final[int] = int(os.getenv("GFP_MCP_TIMEOUT", "300"))
+
+    DEBUG: Final[bool] = os.getenv("GFP_MCP_DEBUG", "false").lower() in (
+        "true",
+        "1",
+        "yes",
+    )
+
+    REGISTRY_API_URL: Final[str] = "https://registry.gdsfactory.com"
+
+    MAX_RETRIES: Final[int] = 3
+    RETRY_BACKOFF: Final[float] = 0.5  # Initial backoff in seconds
+
+    @classmethod
+    def get_api_url(cls, override: str | None = None) -> str | None:
+        """Get the FastAPI base URL.
+
+        Args:
+            override: Optional URL to override the environment variable
+
+        Returns:
+            The API base URL or None if not configured
+        """
+        return override or cls.API_URL
+
+    @classmethod
+    def get_timeout(cls) -> int:
+        """Get the timeout for tool calls.
+
+        Returns:
+            Timeout in seconds
+        """
+        return cls.TIMEOUT
+
+
+def _read_api_key_from_toml(file_path: Path) -> str | None:
+    """Read the API key from a TOML configuration file.
+
+    Args:
+        file_path: Path to the TOML file.
+
+    Returns:
+        The API key string, or None if not found or file doesn't exist.
+    """
+    if not file_path.exists():
+        return None
+
+    try:
+        with open(file_path, "rb") as f:
+            config = tomllib.load(f)
+
+        return (
+            config.get("tool", {}).get("gdsfactoryplus", {}).get("api", {}).get("key")
+        )
+    except Exception:
+        return None
+
+
+def get_gfp_api_key() -> str | None:
+    """Retrieve the GFP API key from environment variables or config files.
+
+    Checks sources in priority order:
+    1. GFP_API_KEY environment variable
+    2. ~/.gdsfactory/gdsfactoryplus.toml
+    3. ./pyproject.toml
+
+    Returns:
+        The API key string, or None if not found.
+    """
+    # 1. Check environment variable (highest priority)
+    api_key = os.environ.get("GFP_API_KEY")
+    if api_key:
+        return api_key
+
+    # 2. Check global config file: ~/.gdsfactory/gdsfactoryplus.toml
+    global_config_path = Path.home() / ".gdsfactory" / "gdsfactoryplus.toml"
+    api_key = _read_api_key_from_toml(global_config_path)
+    if api_key:
+        return api_key
+
+    # 3. Check local project config: ./pyproject.toml
+    local_config_path = Path.cwd() / "pyproject.toml"
+    api_key = _read_api_key_from_toml(local_config_path)
+    if api_key:
+        return api_key
+
+    return None
+
+
+def set_gfp_api_key(api_key: str) -> None:
+    """Save the GFP API key to the global config file.
+
+    Writes to: ~/.gdsfactory/gdsfactoryplus.toml
+
+    Args:
+        api_key: The API key to save.
+
+    Raises:
+        ValueError: If api_key is empty or None.
+    """
+    if not api_key:
+        raise ValueError("API key is required")
+
+    config_dir = Path.home() / ".gdsfactory"
+    config_path = config_dir / "gdsfactoryplus.toml"
+
+    # Create directory if it doesn't exist
+    config_dir.mkdir(parents=True, exist_ok=True)
+
+    # Load existing config or create new one
+    config: dict = {}
+    if config_path.exists():
+        with open(config_path, "rb") as f:
+            config = tomllib.load(f)
+
+    # Set the API key in the nested structure
+    if "tool" not in config:
+        config["tool"] = {}
+    if "gdsfactoryplus" not in config["tool"]:
+        config["tool"]["gdsfactoryplus"] = {}
+    if "api" not in config["tool"]["gdsfactoryplus"]:
+        config["tool"]["gdsfactoryplus"]["api"] = {}
+
+    config["tool"]["gdsfactoryplus"]["api"]["key"] = api_key
+
+    # Write back to file using tomli_w if available, otherwise manual formatting
+    try:
+        import tomli_w
+
+        with open(config_path, "wb") as f:
+            tomli_w.dump(config, f)
+    except ImportError:
+        # Fallback: write TOML manually for this simple structure
+        with open(config_path, "w") as f:
+            f.write("[tool.gdsfactoryplus.api]\n")
+            f.write(f'key = "{api_key}"\n')