axiomatic-mcp 0.0.1__tar.gz

axiomatic_mcp-0.0.1/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: axiomatic-mcp
+Version: 0.0.1
+Summary: Modular MCP servers for Axiomatic_AI
+Author-email: Axiomatic Team <developers@axiomatic.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/axiomatic/ax-mcp
+Project-URL: Issues, https://github.com/axiomatic/ax-mcp/issues
+Keywords: mcp,axiomatic,ai,fastmcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# Axiomatic MCP Server
+
+MCP (Model Context Protocol) server for the Axiomatic_AI platform, built with FastMCP in Python. Provides access to Axiomatic_AI's tools via MCP.
+
+- **FastMCP-based server**: Built on the FastMCP framework for efficient MCP implementation
+- **Axiomatic API integration**: Connects to Axiomatic AI's API for various tooling
+- **Simple configuration**: Easy setup with API key environment variable
+
+## Installation
+
+> **Important**: Not yet released to PyPi. Follow the developer for instructions for now
+
+You can install each domain server independently based on your needs. These can be installed in many MCP clients such as cursor or claude.
+
+**For PIC Domain:**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=axiomatic-pic&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1waWMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
+
+```json
+{
+  "axiomatic-pic": {
+    "command": "uvx",
+    "args": ["--from", "axiomatic-mcp", "axiomatic-pic"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+**For Documents:**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=axiomatic-documents&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1kb2N1bWVudHMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
+
+```json
+{
+  "axiomatic-documents": {
+    "command": "uvx",
+    "args": ["--from", "axiomatic-mcp", "axiomatic-documents"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+## Development
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/axiomatic/ax-mcp.git
+cd ax-mcp
+```
+
+2. Install in development mode:
+
+```bash
+make install-dev
+```
+
+3. Add servers to Cursor using Python module paths:
+
+**For PIC Domain:**
+
+```json
+{
+  "axiomatic-pic": {
+    "command": "python",
+    "args": ["-m", "axiomatic_mcp.servers.pic"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+**For Documents:**
+
+```json
+{
+  "axiomatic-documents": {
+    "command": "python",
+    "args": ["-m", "axiomatic_mcp.servers.documents"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+### Project Structure
+
+```
+ax-mcp/
+├── axiomatic_mcp/
+│   ├── shared/              # Shared utilities
+│   └── servers/             # Domain-specific servers
+├── pyproject.toml           # Python package configuration
+```
+
+### Adding a New Server
+
+1. Create server directory:
+
+```bash
+mkdir axiomatic_mcp/servers/my_domain
+```
+
+2. Create `__init__.py`:
+
+```python
+from .server import MyDomainServer
+
+def main():
+    server = MyDomainServer()
+    server.run()
+```
+
+2. Create `__main__.py`:
+
+```python
+from . import main
+
+if __name__ == "__main__":
+    main()
+```
+
+3. Implement server in `server.py`:
+
+```python
+from fastmcp import FastMCP
+
+mcp = FastMCP(
+    name="NAME",
+    instructions="""GIVE NICE INSTRUCTIONS""",
+    version="0.0.1",
+)
+
+@mcp.tool(
+    name="tool_name",
+    description="DESCRIPTION",
+    tags=["TAG"],
+)
+def my_tool():
+  pass
+
+# Add more tools as needed
+```
+
+4. Add entry point to `pyproject.toml`:
+
+```toml
+[project.scripts]
+axiomatic-mydomain = "axiomatic_mcp.servers.my_domain:main"
+```
+
+5. Update README.md with instructions on installing your server. You can generate the "Add to cursor" button [here](https://docs.cursor.com/en/tools/developers)
+
+## Troubleshooting
+
+### Server not appearing in Cursor
+
+1. Restart Cursor after updating MCP settings
+2. Check the Output panel (View → Output → MCP) for errors
+3. Verify the command path is correct
+
+### Multiple servers overwhelming the LLM
+
+Install only the domain servers you need. Each server runs independently, so you can add/remove them as needed.
+
+### API connection errors
+
+1. Verify your API key is set correctly
+2. Check internet connection
+
+## Release Process
+
+### Publishing a Release
+
+1. Create a new release branch
+1. Update version in `pyproject.toml`
+1. Commit and push changes
+1. Create a pull request titled "Release: YOUR FEATURE(s)". Include detailed description of what's included in the release.
+1. Create a GitHub release with tag `vX.Y.Z`
+1. GitHub Actions automatically publishes to PyPI
+
+The package is available at: https://pypi.org/project/axiomatic-mcp/

axiomatic_mcp-0.0.1/README.md

@@ -0,0 +1,188 @@
+# Axiomatic MCP Server
+
+MCP (Model Context Protocol) server for the Axiomatic_AI platform, built with FastMCP in Python. Provides access to Axiomatic_AI's tools via MCP.
+
+- **FastMCP-based server**: Built on the FastMCP framework for efficient MCP implementation
+- **Axiomatic API integration**: Connects to Axiomatic AI's API for various tooling
+- **Simple configuration**: Easy setup with API key environment variable
+
+## Installation
+
+> **Important**: Not yet released to PyPi. Follow the developer for instructions for now
+
+You can install each domain server independently based on your needs. These can be installed in many MCP clients such as cursor or claude.
+
+**For PIC Domain:**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=axiomatic-pic&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1waWMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
+
+```json
+{
+  "axiomatic-pic": {
+    "command": "uvx",
+    "args": ["--from", "axiomatic-mcp", "axiomatic-pic"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+**For Documents:**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=axiomatic-documents&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1kb2N1bWVudHMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
+
+```json
+{
+  "axiomatic-documents": {
+    "command": "uvx",
+    "args": ["--from", "axiomatic-mcp", "axiomatic-documents"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+## Development
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/axiomatic/ax-mcp.git
+cd ax-mcp
+```
+
+2. Install in development mode:
+
+```bash
+make install-dev
+```
+
+3. Add servers to Cursor using Python module paths:
+
+**For PIC Domain:**
+
+```json
+{
+  "axiomatic-pic": {
+    "command": "python",
+    "args": ["-m", "axiomatic_mcp.servers.pic"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+**For Documents:**
+
+```json
+{
+  "axiomatic-documents": {
+    "command": "python",
+    "args": ["-m", "axiomatic_mcp.servers.documents"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+### Project Structure
+
+```
+ax-mcp/
+├── axiomatic_mcp/
+│   ├── shared/              # Shared utilities
+│   └── servers/             # Domain-specific servers
+├── pyproject.toml           # Python package configuration
+```
+
+### Adding a New Server
+
+1. Create server directory:
+
+```bash
+mkdir axiomatic_mcp/servers/my_domain
+```
+
+2. Create `__init__.py`:
+
+```python
+from .server import MyDomainServer
+
+def main():
+    server = MyDomainServer()
+    server.run()
+```
+
+2. Create `__main__.py`:
+
+```python
+from . import main
+
+if __name__ == "__main__":
+    main()
+```
+
+3. Implement server in `server.py`:
+
+```python
+from fastmcp import FastMCP
+
+mcp = FastMCP(
+    name="NAME",
+    instructions="""GIVE NICE INSTRUCTIONS""",
+    version="0.0.1",
+)
+
+@mcp.tool(
+    name="tool_name",
+    description="DESCRIPTION",
+    tags=["TAG"],
+)
+def my_tool():
+  pass
+
+# Add more tools as needed
+```
+
+4. Add entry point to `pyproject.toml`:
+
+```toml
+[project.scripts]
+axiomatic-mydomain = "axiomatic_mcp.servers.my_domain:main"
+```
+
+5. Update README.md with instructions on installing your server. You can generate the "Add to cursor" button [here](https://docs.cursor.com/en/tools/developers)
+
+## Troubleshooting
+
+### Server not appearing in Cursor
+
+1. Restart Cursor after updating MCP settings
+2. Check the Output panel (View → Output → MCP) for errors
+3. Verify the command path is correct
+
+### Multiple servers overwhelming the LLM
+
+Install only the domain servers you need. Each server runs independently, so you can add/remove them as needed.
+
+### API connection errors
+
+1. Verify your API key is set correctly
+2. Check internet connection
+
+## Release Process
+
+### Publishing a Release
+
+1. Create a new release branch
+1. Update version in `pyproject.toml`
+1. Commit and push changes
+1. Create a pull request titled "Release: YOUR FEATURE(s)". Include detailed description of what's included in the release.
+1. Create a GitHub release with tag `vX.Y.Z`
+1. GitHub Actions automatically publishes to PyPI
+
+The package is available at: https://pypi.org/project/axiomatic-mcp/

axiomatic_mcp-0.0.1/axiomatic_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""Axiomatic MCP Servers - Modular MCP servers built with FastMCP."""
+
+__version__ = "1.0.0"

axiomatic_mcp-0.0.1/axiomatic_mcp/servers/__init__.py

@@ -0,0 +1,9 @@
+"""Domain-specific MCP servers."""
+
+from .pic.server import mcp as pic_mcp
+
+servers = [
+    pic_mcp,
+]
+
+__all__ = ["pic_mcp"]

axiomatic_mcp-0.0.1/axiomatic_mcp/servers/documents/__init__.py

@@ -0,0 +1,5 @@
+def main():
+    """Main entry point for the Documents server."""
+    from .server import mcp
+
+    mcp.run(transport="stdio")

axiomatic_mcp-0.0.1/axiomatic_mcp/servers/documents/__main__.py

@@ -0,0 +1,4 @@
+from . import main
+
+if __name__ == "__main__":
+    main()

axiomatic_mcp-0.0.1/axiomatic_mcp/servers/documents/server.py

@@ -0,0 +1,46 @@
+"""Documents MCP server for filesystem document operations."""
+
+from pathlib import Path
+from typing import Annotated
+
+from fastmcp import FastMCP
+from fastmcp.tools.tool import ToolResult
+from mcp.types import TextContent
+
+from ...shared import AxiomaticAPIClient
+
+mcp = FastMCP(
+    name="Axiomatic Documents Server",
+    instructions="""This server provides tools to read, analyze, and process documents
+    from the filesystem using the Axiomatic_AI Platform.""",
+    version="0.0.1",
+)
+
+
+@mcp.tool(
+    name="document_to_markdown",
+    description="Convert a PDF document to markdown using Axiomatic's advanced OCR.",
+    tags=["document", "filesystem", "analyze"],
+)
+async def document_to_markdown(
+    file_path: Annotated[Path, "The absolute path to the PDF file to analyze"],
+) -> ToolResult:
+    if not file_path.exists():
+        raise FileNotFoundError(f"Document not found: {file_path}")
+
+    if file_path.suffix.lower() != ".pdf":
+        raise ValueError("File must be a PDF")
+
+    file_content = file_path.read_bytes()
+    files = {"file": (file_path.name, file_content, "application/pdf")}
+    data = {"method": "mistral", "ocr": False, "layout_model": "doclayout_yolo"}
+
+    response = AxiomaticAPIClient().post("/document/parse", files=files, data=data)
+    markdown: str = response["markdown"]
+    name = file_path.stem + ".md"
+    return ToolResult(
+        content=[TextContent(type="text", text=f"Generated markdown for: {name}\n\n```markdown\n{markdown}\n```")],
+        structured_content={
+            "suggestions": [{"type": "create_file", "path": name, "content": markdown, "description": f"Create {name} with the generated markdown"}]
+        },
+    )

axiomatic_mcp-0.0.1/axiomatic_mcp/servers/pic/__init__.py

@@ -0,0 +1,5 @@
+def main():
+    """Main entry point for the PIC server."""
+    from .server import mcp
+
+    mcp.run(transport="stdio")

axiomatic_mcp-0.0.1/axiomatic_mcp/servers/pic/__main__.py

@@ -0,0 +1,4 @@
+from . import main
+
+if __name__ == "__main__":
+    main()

axiomatic_mcp-0.0.1/axiomatic_mcp/servers/pic/server.py

@@ -0,0 +1,48 @@
+"""PIC (Photonic Integrated Circuit) domain MCP server."""
+
+from typing import Annotated
+
+from fastmcp import FastMCP
+from fastmcp.tools.tool import ToolResult
+from mcp.types import TextContent
+
+from ...shared import AxiomaticAPIClient
+
+mcp = FastMCP(
+    name="Axiomatic PIC Designer",
+    instructions="""This server provides tools to design, optimize,
+    and simulate photonic integrated circuits.""",
+    version="0.0.1",
+)
+
+
+@mcp.tool(
+    name="design_circuit",
+    description="Design a photonic integrated circuit and optionally create a Python file",
+    tags=["design", "gfsfactory"],
+)
+async def design(
+    query: Annotated[str, "The query to design the circuit"],
+    existing_code: Annotated[str | None, "Existing code to use as a reference to refine"] = None,
+) -> ToolResult:
+    """Design a photonic integrated circuit."""
+    data = {
+        "query": query,
+    }
+
+    if existing_code:
+        data["code"] = existing_code
+
+    response = AxiomaticAPIClient().post("/pic/circuit/refine", data=data)
+    code: str = response["code"]
+
+    file_name = "circuit.py"
+
+    return ToolResult(
+        content=[TextContent(type="text", text=f"Generated photonic circuit design for: {file_name}\n\n```python\n{code}\n```")],
+        structured_content={
+            "suggestions": [
+                {"type": "create_file", "path": file_name, "content": code, "description": f"Create {file_name} with the generated circuit design"}
+            ]
+        },
+    )

axiomatic_mcp-0.0.1/axiomatic_mcp/shared/__init__.py

@@ -0,0 +1,7 @@
+"""Shared utilities for Axiomatic MCP servers."""
+
+from .api_client import AxiomaticAPIClient
+
+__all__ = [
+    "AxiomaticAPIClient",
+]

axiomatic_mcp-0.0.1/axiomatic_mcp/shared/api_client.py

@@ -0,0 +1,47 @@
+import os
+from typing import Any
+
+import httpx
+
+API_URL = "https://api.axiomatic-ai.com"
+TIMEOUT = 1000
+
+
+class AxiomaticAPIClient:
+    def __init__(self):
+        api_key = os.getenv("AXIOMATIC_API_KEY")
+        if not api_key:
+            raise ValueError("AXIOMATIC_API_KEY environment variable is not set")
+
+        self.client = httpx.Client(
+            base_url=API_URL,
+            timeout=TIMEOUT,
+            headers={
+                "X-API-Key": api_key,
+            },
+        )
+
+    def get(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        response = self.client.get(endpoint, params=params)
+        response.raise_for_status()
+        return response.json()
+
+    def post(
+        self,
+        endpoint: str,
+        data: dict[str, Any] | None = None,
+        files: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        response = self.client.post(endpoint, files=files, data=data) if files else self.client.post(endpoint, json=data)
+        response.raise_for_status()
+        return response.json()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.client.close()

axiomatic_mcp-0.0.1/axiomatic_mcp.egg-info/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: axiomatic-mcp
+Version: 0.0.1
+Summary: Modular MCP servers for Axiomatic_AI
+Author-email: Axiomatic Team <developers@axiomatic.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/axiomatic/ax-mcp
+Project-URL: Issues, https://github.com/axiomatic/ax-mcp/issues
+Keywords: mcp,axiomatic,ai,fastmcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# Axiomatic MCP Server
+
+MCP (Model Context Protocol) server for the Axiomatic_AI platform, built with FastMCP in Python. Provides access to Axiomatic_AI's tools via MCP.
+
+- **FastMCP-based server**: Built on the FastMCP framework for efficient MCP implementation
+- **Axiomatic API integration**: Connects to Axiomatic AI's API for various tooling
+- **Simple configuration**: Easy setup with API key environment variable
+
+## Installation
+
+> **Important**: Not yet released to PyPi. Follow the developer for instructions for now
+
+You can install each domain server independently based on your needs. These can be installed in many MCP clients such as cursor or claude.
+
+**For PIC Domain:**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=axiomatic-pic&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1waWMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
+
+```json
+{
+  "axiomatic-pic": {
+    "command": "uvx",
+    "args": ["--from", "axiomatic-mcp", "axiomatic-pic"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+**For Documents:**
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=axiomatic-documents&config=eyJjb21tYW5kIjoidXZ4IC0tZnJvbSBheGlvbWF0aWMtbWNwIGF4aW9tYXRpYy1kb2N1bWVudHMiLCJlbnYiOnsiQVhJT01BVElDX0FQSV9LRVkiOiJFTlRFUiBZT1VSIEFQSSBLRVkifX0%3D)
+
+```json
+{
+  "axiomatic-documents": {
+    "command": "uvx",
+    "args": ["--from", "axiomatic-mcp", "axiomatic-documents"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+## Development
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/axiomatic/ax-mcp.git
+cd ax-mcp
+```
+
+2. Install in development mode:
+
+```bash
+make install-dev
+```
+
+3. Add servers to Cursor using Python module paths:
+
+**For PIC Domain:**
+
+```json
+{
+  "axiomatic-pic": {
+    "command": "python",
+    "args": ["-m", "axiomatic_mcp.servers.pic"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+**For Documents:**
+
+```json
+{
+  "axiomatic-documents": {
+    "command": "python",
+    "args": ["-m", "axiomatic_mcp.servers.documents"],
+    "env": {
+      "AXIOMATIC_API_KEY": "your-api-key-here"
+    }
+  }
+}
+```
+
+### Project Structure
+
+```
+ax-mcp/
+├── axiomatic_mcp/
+│   ├── shared/              # Shared utilities
+│   └── servers/             # Domain-specific servers
+├── pyproject.toml           # Python package configuration
+```
+
+### Adding a New Server
+
+1. Create server directory:
+
+```bash
+mkdir axiomatic_mcp/servers/my_domain
+```
+
+2. Create `__init__.py`:
+
+```python
+from .server import MyDomainServer
+
+def main():
+    server = MyDomainServer()
+    server.run()
+```
+
+2. Create `__main__.py`:
+
+```python
+from . import main
+
+if __name__ == "__main__":
+    main()
+```
+
+3. Implement server in `server.py`:
+
+```python
+from fastmcp import FastMCP
+
+mcp = FastMCP(
+    name="NAME",
+    instructions="""GIVE NICE INSTRUCTIONS""",
+    version="0.0.1",
+)
+
+@mcp.tool(
+    name="tool_name",
+    description="DESCRIPTION",
+    tags=["TAG"],
+)
+def my_tool():
+  pass
+
+# Add more tools as needed
+```
+
+4. Add entry point to `pyproject.toml`:
+
+```toml
+[project.scripts]
+axiomatic-mydomain = "axiomatic_mcp.servers.my_domain:main"
+```
+
+5. Update README.md with instructions on installing your server. You can generate the "Add to cursor" button [here](https://docs.cursor.com/en/tools/developers)
+
+## Troubleshooting
+
+### Server not appearing in Cursor
+
+1. Restart Cursor after updating MCP settings
+2. Check the Output panel (View → Output → MCP) for errors
+3. Verify the command path is correct
+
+### Multiple servers overwhelming the LLM
+
+Install only the domain servers you need. Each server runs independently, so you can add/remove them as needed.
+
+### API connection errors
+
+1. Verify your API key is set correctly
+2. Check internet connection
+
+## Release Process
+
+### Publishing a Release
+
+1. Create a new release branch
+1. Update version in `pyproject.toml`
+1. Commit and push changes
+1. Create a pull request titled "Release: YOUR FEATURE(s)". Include detailed description of what's included in the release.
+1. Create a GitHub release with tag `vX.Y.Z`
+1. GitHub Actions automatically publishes to PyPI
+
+The package is available at: https://pypi.org/project/axiomatic-mcp/

axiomatic_mcp-0.0.1/axiomatic_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+axiomatic_mcp/__init__.py
+axiomatic_mcp.egg-info/PKG-INFO
+axiomatic_mcp.egg-info/SOURCES.txt
+axiomatic_mcp.egg-info/dependency_links.txt
+axiomatic_mcp.egg-info/entry_points.txt
+axiomatic_mcp.egg-info/requires.txt
+axiomatic_mcp.egg-info/top_level.txt
+axiomatic_mcp/servers/__init__.py
+axiomatic_mcp/servers/documents/__init__.py
+axiomatic_mcp/servers/documents/__main__.py
+axiomatic_mcp/servers/documents/server.py
+axiomatic_mcp/servers/pic/__init__.py
+axiomatic_mcp/servers/pic/__main__.py
+axiomatic_mcp/servers/pic/server.py
+axiomatic_mcp/shared/__init__.py
+axiomatic_mcp/shared/api_client.py

axiomatic_mcp-0.0.1/axiomatic_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

axiomatic_mcp-0.0.1/axiomatic_mcp.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+axiomatic-documents = axiomatic_mcp.servers.documents:main
+axiomatic-pic = axiomatic_mcp.servers.pic:main

axiomatic_mcp-0.0.1/axiomatic_mcp.egg-info/requires.txt

@@ -0,0 +1,10 @@
+fastmcp>=0.1.0
+pydantic>=2.0.0
+python-dotenv>=1.0.0
+httpx>=0.25.0
+
+[dev]
+pytest>=7.0.0
+black>=23.0.0
+ruff>=0.1.0
+mypy>=1.0.0

axiomatic_mcp-0.0.1/axiomatic_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+axiomatic_mcp

axiomatic_mcp-0.0.1/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "axiomatic-mcp"
+version = "0.0.1"
+description = "Modular MCP servers for Axiomatic_AI"
+authors = [{name = "Axiomatic Team", email = "developers@axiomatic.ai"}]
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+keywords = ["mcp", "axiomatic", "ai", "fastmcp"]
+urls = {Homepage = "https://github.com/axiomatic/ax-mcp", Issues = "https://github.com/axiomatic/ax-mcp/issues"}
+dependencies = [
+    "fastmcp>=0.1.0",
+    "pydantic>=2.0.0",
+    "python-dotenv>=1.0.0",
+    "httpx>=0.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[project.scripts]
+axiomatic-pic = "axiomatic_mcp.servers.pic:main"
+axiomatic-documents = "axiomatic_mcp.servers.documents:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["axiomatic_mcp*"]
+
+[tool.black]
+line-length = 150
+target-version = ["py310", "py311", "py312"]
+
+[tool.ruff]
+line-length = 150
+target-version = "py310"
+select = ["E", "F", "I", "N", "UP", "B", "C4", "PTH", "SIM", "RUF"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = true
+warn_unused_configs = true

axiomatic_mcp-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+