origin-mcp
origin-mcp is a local Model Context Protocol (MCP) server that lets AI
assistants control Origin/OriginPro on Windows. An authenticated local bridge
runs inside Origin so automation stays on its UI thread. The project is still
in testing; real-workflow feedback and contributions are welcome.
Highlights
- Import, edit, transform, and export worksheet, matrix, image, and connector data.
- Create and refine 2D, 3D, contour, statistical, and specialized plots.
- Run fitting, signal processing, statistics, Peak Analyzer, and batch workflows.
- Manage projects, folders, Notes, templates, analysis operations, and graph layouts.
- Build publication figures with reusable templates, palettes, and an optional Nature-style preset.
Quick Start
You need Windows, a licensed Origin/OriginPro installation, and Python 3.10+ for the MCP server. Origin 2026/2026b is the current target family; the bridge uses the Python bundled with Origin.
- Install the MCP server:
pip install origin-mcp
- Add the MCP server to your client (use the absolute
python.exepath ifpythonpoints to another environment):
{
"mcpServers": {
"origin": {
"command": "python",
"args": ["-m", "origin_mcp"]
}
}
}
- Install the Origin Start/Stop Apps, follow the short registration guide, then click Origin MCP Bridge Start once per Origin session:
origin-mcp install-origin-app --force
- Verify the bridge and live Origin connection:
origin-mcp status
origin-mcp doctor --ping-origin
Both diagnostic commands support --json. For manual bridge startup or
troubleshooting, see the bridge guide.
To let an AI agent install and configure origin-mcp, send it this instruction:
Fetch and follow https://raw.githubusercontent.com/Ge-Shun/origin-mcp/main/docs/agentic/origin-mcp-bootstrap.md end to end.
Documentation
- MCP client configuration
- Origin Start/Stop Apps
- Bridge setup and troubleshooting
- Tools, profiles, styling, and error recovery
- Agentic bootstrap guide
Development
From a checkout, install with pip install -e . and run the full local gate:
python scripts/dev_check.py --tests
Security
The bridge listens only on 127.0.0.1 and authenticates local requests by
default with a per-session token. Treat the token as a credential, keep its
handshake file in a user-private directory, and avoid
ORIGIN_MCP_BRIDGE_NO_AUTH unless every local process is trusted. Set
ORIGIN_MCP_ALLOWED_ROOTS to restrict which files tools may access.
License
MIT. See LICENSE.
Metadata
Release files for origin-mcp 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| origin_mcp-0.1.4.tar.gz | 760.8 kB | Without provenance | Details for origin_mcp-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| origin_mcp-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for origin_mcp-0.1.4-py3-none-any.whl |
Total release size: 1.1 MB
Release files / origin_mcp-0.1.4.tar.gz
| Download URL | origin_mcp-0.1.4.tar.gz |
|---|---|
| Size | 760.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
57ba58ddf9f10814ed20f7678974989bfabdc28e29782515258010cbfcc0d5b2
|
|
BLAKE2b-256 checksum How to use checksums |
cb69c86cfa314f532109849a3a0a9a0b6e03d05d0f68c74f8bc8c159005fac33
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Release files / origin_mcp-0.1.4-py3-none-any.whl
| Download URL | origin_mcp-0.1.4-py3-none-any.whl |
|---|---|
| Size | 351.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2a9a3a31a41b23dd0a328c1a383f819c3966d9f6de518ef08a546f3cfdf4f845
|
|
BLAKE2b-256 checksum How to use checksums |
b5dc4bb6e24c38ee27124f6bb444864b9ff08985c093503a99154eb3e5f1e811
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Security for origin-mcp 0.1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.