io.github.borgi-s/dfxm-geo-mcp
MCP server for the dfxm-geo dark-field X-ray microscopy forward model
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
dfxm-geo-mcpclaude mcp add dfxm-geo-mcp -- uvx dfxm-geo-mcp==0.1.0
{
"mcpServers": {
"dfxm-geo-mcp": {
"command": "uvx",
"args": [
"dfxm-geo-mcp==0.1.0"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
dfxm-geo-mcp
An MCP server that lets an AI client drive the dfxm-geo dark-field X-ray microscopy forward model: validate and scaffold configs, enumerate reachable reflections, and render preview-scale simulations.
Run
uvx dfxm-geo-mcp
Claude Desktop (claude_desktop_config.json):
{"mcpServers": {"dfxm-geo": {"command": "uvx", "args": ["dfxm-geo-mcp"]}}}
Or: pip install dfxm-geo-mcp then dfxm-geo-mcp.
First run pulls a heavy scientific stack (numba/scipy) and warms a JIT cache (~10 s once). No fake demo mode — the sims are real.
Tools
validate_config · find_reflections · predict_visibility (g·b reflection-visibility ranking; structured scores plus a self-contained .html) · scaffold_config · run_forward (analytic preview; saves a PNG and a self-contained .html) · run_rocking (interactive φ-rocking-curve viewer: a single self-contained .html with a frame scrubber + live rocking-curve plot) · start_bootstrap / get_job_status / get_job_result (MC fidelity).
Both run_forward and run_rocking write self-contained HTML (image(s) embedded, all CSS/JS inline, no external origins) that opens full-size in any browser and is surfaced by file-showing clients.
Architecture
A protocol-agnostic ops layer wrapping dfxm-geo, under a thin FastMCP adapter. See docs/superpowers/specs/.
Roadmap (v2)
run_identify · remote HTTP transport · .mcpb bundle.
Frequently asked questions
What is io.github.borgi-s/dfxm-geo-mcp?
MCP server for the dfxm-geo dark-field X-ray microscopy forward model
How do I install io.github.borgi-s/dfxm-geo-mcp?
It runs on your machine. In Claude Code: claude mcp add dfxm-geo-mcp -- uvx dfxm-geo-mcp==0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.borgi-s/dfxm-geo-mcp need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.borgi-s/dfxm-geo-mcp open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.borgi-s/dfxm-geo-mcp?
It is published by borgi-s. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.