Metadata-Version: 2.4
Name: jmri-mcp
Version: 1.0.0rc4
Summary: MCP server for JMRI - voice/chat control of DCC model railroads (xiaozhi, Claude, ...)
Project-URL: Homepage, https://github.com/HO44-PROJECT/MrJ-JMRI-MCP
Project-URL: Repository, https://github.com/HO44-PROJECT/MrJ-JMRI-MCP
Author-email: HO PROJECT <HO44-PROJECT@users.noreply.github.com>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Home Automation
Requires-Python: >=3.10
Requires-Dist: jmri-core==1.0.0rc4
Requires-Dist: mcp~=1.28
Provides-Extra: test
Requires-Dist: jmri-core[test]==1.0.0rc4; extra == 'test'
Provides-Extra: xiaozhi
Requires-Dist: python-dotenv~=1.2; extra == 'xiaozhi'
Description-Content-Type: text/markdown

# jmri-mcp

MCP (Model Context Protocol) server for [JMRI](https://www.jmri.org/) —
control your DCC model railroad by voice or chat, through any MCP client:
Claude Desktop, Claude Code, [xiaozhi](https://github.com/78/xiaozhi-esp32)
voice assistants, etc.

```
pip install jmri-mcp
```

See the [project repository](https://github.com/HO44-PROJECT/MrJ-JMRI-MCP)
for full documentation, including
[docs/llm-setup-claude.md](https://github.com/HO44-PROJECT/MrJ-JMRI-MCP/blob/main/docs/llm-setup-claude.md)
and
[docs/llm-setup-xiaozhi.md](https://github.com/HO44-PROJECT/MrJ-JMRI-MCP/blob/main/docs/llm-setup-xiaozhi.md)
for wiring this server into Claude Desktop/Code or xiaozhi/Kira.

Looking for a plain terminal client instead? See
[`jmri-cli`](https://pypi.org/project/jmri-cli/).

## Third-party code

This package includes `xiaozhi_wrapper`, adapted from the MCP pipe example in
[xiaozhi-esp32](https://github.com/78/xiaozhi-esp32) (MIT License, Copyright
(c) 2025 Shenzhen Xinzhi Future Technology Co., Ltd. and Project
Contributors) — see `src/xiaozhi_wrapper/__init__.py`'s module docstring
(inside this package) for the full notice.
