axiomatic-mcp 0.1.0

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

🖌️ AxEquationExplorer

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

📄 AxDocumentParser

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

📝 AxDocumentAnnotator

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

⚙️ AxModelFitter

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

🔬 AxPhotonicsPreview

Design photonic integrated circuits using natural language descriptions.

📊 AxPlotToData

Extract numerical data from plot images for analysis and reproduction.

Getting an API Key

1. Fill the following form 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

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 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. 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 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
• 💡 Request a Feature
• 📋 View All Issues
• 💬 Discord Server

Support

• Join our Discord Server
• Issues: GitHub Issues
• Email: [e-mail]