Metadata-Version: 2.4
Name: axiomatic-mcp
Version: 0.1.0
Summary: Modular MCP servers for Axiomatic_AI
Author-email: Axiomatic Team <developers@axiomatic-ai.com>
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.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
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
Requires-Dist: gdsfactory>=9.7.0
Requires-Dist: cspdk>=1.0.1
Requires-Dist: kfactory>=1.7.3
Requires-Dist: klayout>=0.30.2
Requires-Dist: iklayout>=0.0.8
Requires-Dist: ipympl>=0.9.7
Requires-Dist: klujax>=0.4.3
Requires-Dist: sax>=0.14.5
Requires-Dist: plotly>=6.1.2
Requires-Dist: nbformat>=5.10.4
Requires-Dist: debugpy>=1.8.0
Requires-Dist: numpy>=1.21.0
Requires-Dist: scikit-learn>=1.0.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: moesifasgi>=1.1.5
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"
Requires-Dist: debugpy>=1.8.0; extra == "dev"
Provides-Extra: lean
Requires-Dist: leanclient==0.1.14; extra == "lean"
Provides-Extra: pic
Requires-Dist: gdsfactory>=9.7.0; extra == "pic"
Requires-Dist: cspdk>=1.0.1; extra == "pic"
Requires-Dist: kfactory>=1.7.3; extra == "pic"
Requires-Dist: klayout>=0.30.2; extra == "pic"
Requires-Dist: iklayout>=0.0.8; extra == "pic"
Requires-Dist: ipympl>=0.9.7; extra == "pic"
Requires-Dist: klujax>=0.4.3; extra == "pic"
Requires-Dist: sax>=0.14.5; extra == "pic"
Requires-Dist: plotly>=6.1.2; extra == "pic"
Requires-Dist: numpy>=1.21.0; extra == "pic"
Requires-Dist: pandas>=1.3.0; extra == "pic"
Requires-Dist: scikit-learn>=1.0.0; extra == "pic"

# 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

### 🖌️ [AxEquationExplorer](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/equations/)

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

### 📄 [AxDocumentParser](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/documents/)

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

### 📝 [AxDocumentAnnotator](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/annotations/)

Create intelligent annotations for PDF documents with contextual analysis, equation extraction, and parameter identification.

### ⚙️ [AxModelFitter](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/axmodelfitter/)

Fit parametric models or digital twins to observational data using advanced statistical analysis and optimization algorithms.

### 🔬 [AxPhotonicsPreview](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/pic/)

Design photonic integrated circuits using natural language descriptions.

### 📊 [AxPlotToData](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/plots/)

Extract numerical data from plot images for analysis and reproduction.

## Getting an API Key

1. Fill the following [form](https://docs.google.com/forms/d/e/1FAIpQLSfScbqRpgx3ZzkCmfVjKs8YogWDshOZW9p-LVXrWzIXjcHKrQ/viewform?usp=dialog) to request an Axiomatic_AI API key.
2. Once received, add the API key to your MCP client configuration as described in the Configuration section below.

## Configuration

Add the following settings to your MCP client configuration file or environment variables.

### API Key

All Axiomatic MCP servers require an API:

- `AXIOMATIC_API_KEY`: Your API key obtained after filling the request form.

### Telemetry

By default, we track tool usage to help us improve the services. You can optionally disable this feature:

- Set `DISABLE_TELEMETRY: "true"` in your MCP client configuration.

## Installation

### System requirements

- Python
- [uv](https://docs.astral.sh/uv/getting-started/installation/)

### Individual MCP server installation

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

### Install all servers

Copy the content of the [mcp-example.json](mcp-example.json) file into your AI client MCP server config json.

### 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.

## 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

## Contributing

We welcome contributions from the community! Here's how you can help:

### Submitting Pull Requests

We love pull requests! If you'd like to contribute code:

1. Fork the repository
2. Create a new branch for your feature or fix
3. Make your changes and test them thoroughly
4. Submit a pull request with a clear description of your changes
5. Reference any related issues in your PR description

### Reporting Bugs

Found a bug? Please help us fix it by [creating a bug report](https://github.com/Axiomatic-AI/ax-mcp/issues/new?template=bug_report.md). When reporting bugs:

- Use the bug report template to provide all necessary information
- Include steps to reproduce the issue
- Add relevant error messages and logs
- Specify your environment details (OS, Python version, etc.)

### Requesting Features

Have an idea for a new feature? We'd love to hear it! [Submit a feature request](https://github.com/Axiomatic-AI/ax-mcp/issues/new?template=feature_request.md) and:

- Describe the problem your feature would solve
- Explain your proposed solution
- Share any alternatives you've considered
- Provide specific use cases

### Quick Links

- 🐛 [Report a Bug](https://github.com/Axiomatic-AI/ax-mcp/issues/new?template=bug_report.md)
- 💡 [Request a Feature](https://github.com/Axiomatic-AI/ax-mcp/issues/new?template=feature_request.md)
- 📋 [View All Issues](https://github.com/Axiomatic-AI/ax-mcp/issues)
- 💬 [Discord Server](https://discord.gg/KKU97ZR5)

## Support

- **Join our [Discord Server](https://discord.gg/KKU97ZR5)**
- **Issues**: [GitHub Issues](https://github.com/Axiomatic-AI/ax-mcp/issues)
- **Email**: developers@axiomatic-ai.com
