docs: add uvx MCP installation path

This commit is contained in:
Hermes Agent
2026-08-02 17:23:55 +02:00
parent 490d8d27d5
commit d6c1f9a280
2 changed files with 41 additions and 4 deletions
+27 -4
View File
@@ -127,7 +127,29 @@ No paid API is required.
- Python 3.11+
- `uv` recommended, or any Python package installer capable of creating a virtual environment
### Local install with `uv`
### Simplest install: run directly with `uvx`
You do not need to clone the repository manually. Hermes can let `uvx` install
and run the MCP server directly from Gitea:
```yaml
mcp_servers:
openherbarium:
command: "uvx"
args:
- "--from"
- "git+https://git.home-deneuville.fr/Edern/openherbarium-mcp.git"
- "openherbarium-mcp"
timeout: 120
connect_timeout: 60
```
Restart Hermes Agent after editing `~/.hermes/config.yaml`.
An equivalent ready-to-copy snippet is available at
[`examples/hermes-openherbarium-uvx.yaml`](examples/hermes-openherbarium-uvx.yaml).
### Development install with `uv`
```bash
git clone https://git.home-deneuville.fr/Edern/openherbarium-mcp.git
@@ -141,15 +163,16 @@ Run tests:
uv run pytest
```
Run the MCP server over stdio:
Run the MCP server over stdio from the checked-out project:
```bash
uv run openherbarium-mcp
```
## Hermes Agent configuration
## Hermes Agent configuration for local development
Add the server to `~/.hermes/config.yaml`:
If you want to work on the source code locally instead of using the `uvx` setup,
add the checked-out server to `~/.hermes/config.yaml`:
```yaml
mcp_servers:
+14
View File
@@ -0,0 +1,14 @@
# Drop this under ~/.hermes/config.yaml -> mcp_servers
# No manual clone is required: uvx installs/runs OpenHerbarium MCP from Gitea.
openherbarium:
command: "uvx"
args:
- "--from"
- "git+https://git.home-deneuville.fr/Edern/openherbarium-mcp.git"
- "openherbarium-mcp"
timeout: 120
connect_timeout: 60
# Optional, only needed for targeted source search:
# env:
# FIRECRAWL_API_URL: "http://localhost:3002"
# FIRECRAWL_API_KEY: ""