项目介绍
Axiomatic MCP 服务器
MCP（模型上下文协议）服务器提供AI助手访问Axiomatic_AI平台——一套用于科学计算、文档处理和光子电路设计的高级工具。
🚀 快速开始
1. 检查系统需求
- Python
- 安装 这里
- uv
- 安装额外的包（可选）
- 如果您希望使用AxPhotonicsPreview，则需要在继续之前安装额外的依赖项。安装uv后，运行
uv tool install "axiomatic-mcp[pic]"。
- 如果您希望使用AxPhotonicsPreview，则需要在继续之前安装额外的依赖项。安装uv后，运行
2. 安装您喜欢的客户端
3. 获取API密钥
您将在填写表单后不久通过电子邮件收到API密钥。如果未到达，请检查垃圾邮件文件夹。
4. 安装Axiomatic操作符（除AxPhotonicsPreview外的所有操作符）
<details> <summary><strong>⚡ Claude Code</strong></summary>claude mcp add axiomatic-mcp --env AXIOMATIC_API_KEY=您的API密钥 -- uvx --from axiomatic-mcp all
- 打开Claude Desktop设置 → 开发者 → 编辑MCP配置
- 添加以下配置：
{
"mcpServers": {
"axiomatic-mcp": {
"command": "uvx",
"args": ["--from", "axiomatic-mcp", "all"],
"env": {
"AXIOMATIC_API_KEY": "您的API密钥"
}
}
}
}
- 重启Claude Desktop
遵循MCP安装指南并使用上述标准配置。 查看官方说明：Gemini CLI MCP服务器指南
{
"axiomatic-mcp": {
"command": "uvx",
1. "args": ["--from", "axiomatic-mcp", "all"],
2. "env": {
3. "AXIOMATIC_API_KEY": "您的API密钥"
4. }
5. }
6. }
7. ```
8. </details>
9.
10. <details>
11. <summary><strong>🌬️ Windsurf</strong></summary>
12.
13. 遵循 [Windsurf MCP文档](https://docs.windsurf.com/windsurf/cascade/mcp)。
14. 使用上述标准配置。
15.
16. ```json
17. {
18. "axiomatic-mcp": {
19. "command": "uvx",
20. "args": ["--from", "axiomatic-mcp", "all"],
21. "env": {
22. "AXIOMATIC_API_KEY": "您的API密钥"
23. }
24. }
25. }
26. ```
27. </details>
28.
29. <details>
30. <summary><strong>🧪 LM Studio</strong></summary>
31.
32. #### 单击按钮进行安装：
33.
34. [](https://lmstudio.ai/install-mcp?name=axiomatic-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJheGlvbWF0aWMtbWNwIiwiYWxsIl19)
35.
36. > **注意：** 通过按钮安装后，打开LM Studio MCP设置并添加：
37. >
38. > ```json
39. > "env": {
40. > "AXIOMATIC_API_KEY": "您的API密钥"
41. > }
42. > ```
43.
44. </details>
45.
46. <details>
47. <summary><strong>💻 Codex</strong></summary>
48.
49. 创建或编辑配置文件 `~/.codex/config.toml` 并添加：
50.
51. ```toml
52. [mcp_servers.axiomatic-mcp]
53. command = "uvx"
54. args = ["--from", "axiomatic-mcp", "all"]
55. env = { AXIOMATIC_API_KEY = "您的API密钥" }
56. ```
57.
58. 有关更多信息，请参阅 [Codex MCP文档](https://github.com/openai/codex/blob/main/codex-rs/config.md#mcp_servers)
59.
60. </details>
61. <details>
62. <summary><strong>🌊 其他MCP客户端</strong></summary>
63.
64. 使用此服务器配置：
65.
66. ```json
67. {
68. "command": "uvx",
69. "args": ["--from", "axiomatic-mcp", "all"],
70. "env": {
71. "AXIOMATIC_API_KEY": "您的API密钥"
72. }
73. }
74. ```
75. </details>
76.
77. > **注意：** 这会安装除AxPhotonicsPreview之外的所有工具在一个服务器下。如果您遇到其他问题，请尝试 [单独的服务器](#单独的服务器)。
78.
79. ## 报告错误
80.
81. 发现错误？请帮助我们修复它，[创建一个错误报告](https://github.com/Axiomatic-AI/ax-mcp/issues/new?template=bug_report.md)。
82.
83. ## 在Discord上连接
84.
85. 加入我们的Discord，与其他使用Axiomatic操作符的工程师和科学家互动。寻求帮助，讨论错误和功能，并成为Axiomatic社区的一部分！
86.
87. [](https://discord.gg/KKU97ZR5)
88.
89. ## 故障排除
90.
91. ### 无法在Conda环境中安装
92.
93. 不建议在conda环境中安装axiomatic操作符。`uv`处理独立的Python环境，因此可以“全局”运行而不影响现有的Python环境。
94.
95. ### 服务器未出现在Cursor中
96.
97. 1. 更新MCP设置后重新启动Cursor
98. 2. 检查输出面板中的错误（视图 → 输出 → MCP）
99. 3. 验证命令路径是否正确
100.
101. ### “添加到Cursor”的按钮不起作用
102.
103. 我们看到过Cursor窗口无法正确打开的报告。如果发生这种情况，您可以手动添加到Cursor：
104.
105. 1. 打开Cursor
106. 2. 转到“设置” > “Cursor设置” > “MCP & 集成”
107. 3. 点击“新建MCP服务器”
108. 4. 添加以下配置：
109.
110. ```
111. {
112. "mcpServers": {
113. "axiomatic-mcp": {
114. "command": "uvx --from axiomatic-mcp all",
115. "env": {
116. "AXIOMATIC_API_KEY": "您的API密钥"
117. },
118. "args": []
119. }
120. }
121. }
122. ```
123.
124. ### 多个服务器压垮LLM
125.
126. 只安装您需要的领域服务器。每个服务器独立运行，因此您可以根据需要添加或移除它们。
127.
128. ### API连接错误
129.
130. 1. 验证您的API密钥是否设置正确
131. 2. 检查互联网连接
132.
133. ### 工具未出现
134.
135. 如果您遇到任何问题，例如工具未出现，可能是您正在使用旧版本，需要清除uv的缓存以更新它。
136.
137. ```bash
138. uv cache clean
139. ```
140.
141. 然后重新启动您的MCP客户端（例如，重新启动Cursor）。
142.
143. 这将清除uv缓存并在下次运行时强制下载新的包。
144.
145. ## 单独的服务器
146.
147. 您可以在各自的README中找到关于每个服务器的更多信息以及如何单独安装它们。
148.
149. ### 🖌️ [AxEquationExplorer](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/equations/)
150.
151. 根据科学论文中的信息编写感兴趣的方程。
152.
153. ### 📄 [AxDocumentParser](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/documents/)
154.
155. 将PDF文档转换为markdown，具有高级OCR和布局理解。
156.
157. ### 📝 [AxDocumentAnnotator](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/annotations/)
158.
159. 为PDF文档创建智能注释，包括上下文分析、方程提取和参数识别。
160.
161. ### 🔬 [AxPhotonicsPreview](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/pic/)
162.
163. 使用自然语言描述设计光子集成电路。需要额外的要求，请参见 [检查系统需求](#1-检查系统需求)
164.
165. ### 📊 [AxPlotToData](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/plots/)
166.
167. 从绘图图像中提取数值数据进行分析和复制。
168.
169. ### ⚙️ [AxModelFitter](https://github.com/Axiomatic-AI/ax-mcp/tree/main/axiomatic_mcp/servers/axmodelfitter/)
170.
171. 使用先进的统计分析和优化算法将参数模型或数字孪生拟合到观测数据。
172.
173. ## 请求功能
174.
175. 有新功能的想法吗？我们很乐意听到！[提交功能请求](https://github.com/Axiomatic-AI/ax-mcp/issues/new?template=feature_request.md)并：
176.
177. - 描述您的功能将解决的问题
178. - 解释您的解决方案
179. - 分享您考虑过的替代方案
180. - 提供具体的用例
181.
182. ## 支持
183.
184. - **加入我们的 [Discord服务器](https://discord.gg/KKU97ZR5)**
185. - **问题**：[GitHub问题](https://github.com/Axiomatic-AI/ax-mcp/issues)