axiomatic-mcp 0.0a3

Modular MCP servers for Axiomatic_AI

Axiomatic MCP Servers

MCP (Model Context Protocol) servers that provide AI assistants with access to the Axiomatic_AI Platform - a suite of advanced tools for scientific computing, document processing, and photonic circuit design.

Available Servers

📄 Documents Server

Convert PDF documents to markdown with advanced OCR and layout understanding.

🖌️ Equations Server

Compose equation of your interest based on information in the scientific paper.

🔬 PIC Designer Server

Design photonic integrated circuits using natural language descriptions.

📊 Plots Server

Extract numerical data from plot images for analysis and reproduction.

🖥️ Code Execution Server

Execute Python code in a secure environment with support for selected libraries (gdsfactory, z3, json).
Useful for photonic design workflows, symbolic reasoning, and structured data manipulation.

Getting an API Key

All Axiomatic MCP servers require an API key:

1. Contact [e-mail] to request access
2. Add the API key to your MCP client configuration as AXIOMATIC_API_KEY

Installation

Installation instructions can be found for each specific server in their README.

Setting up MCP Servers in AI Clients

Claude Desktop

1. Open Claude Desktop settings
2. Navigate to Developer → Edit MCP config
3. Add the server configuration(s) above
4. Restart Claude Desktop

Cursor

1. Open Cursor settings (Cmd/Ctrl + ,)
2. Search for "MCP"
3. Add the server configuration(s) to the MCP settings
4. Restart Cursor

Other MCP Clients

Refer to your client's documentation for MCP server configuration.

Development

Local Development Setup

1. Clone the repository:

git clone https://github.com/axiomatic/ax-mcp.git
cd ax-mcp

2. Install in development mode:

make install-dev

3. Configure your MCP client to use local Python modules:

See specific MCP server README for specific installation instructions.

{
  "axiomatic-documents": {
    "command": "python",
    "args": ["-m", "axiomatic_mcp.servers.documents"],
    "env": {
      "AXIOMATIC_API_KEY": "your-api-key-here"
    }
  }
}

Adding a New Server

1. Create server directory:

mkdir axiomatic_mcp/servers/my_domain

2. Create __init__.py:

from .server import MyDomainServer

def main():
    server = MyDomainServer()
    server.run()

2. Create __main__.py:

from . import main

if __name__ == "__main__":
    main()

3. Implement server in server.py:

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:

[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

6. Don't forget to link to your server's README.md in the main project README.md

Release Process

Publishing a Release

1. Create a new release branch
2. Update version in pyproject.toml
3. Commit and push changes
4. Create a pull request titled "Release: YOUR FEATURE(s)". Include detailed description of what's included in the release.
5. Create a GitHub release with tag vX.Y.Z
6. GitHub Actions automatically publishes to PyPI

The package is available at: https://pypi.org/project/axiomatic-mcp/

Contributing

We welcome contributions! To add a new server or improve existing ones:

1. Fork the repository
2. Create a feature branch
3. Implement your changes following the existing patterns
4. Add documentation to your server directory
5. Submit a pull request

For detailed guidelines on adding new servers, see the Development section.

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

Support

• Issues: GitHub Issues
• Email: [e-mail]

Creating >>Add to Cursor<< button:

Copy your MCP client configuration and paste it there:

https://docs.cursor.com/en/tools/developers#generate-install-link