Edern/openherbarium-mcp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: document MCP environment configuration

Browse Source
This commit is contained in:
Hermes Agent
2026-08-02 17:37:34 +02:00
parent bb7ee08152
commit b812292d56
8 changed files with 87 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+37 -6
View File
@@ -142,6 +142,11 @@ mcp_servers:
- "openherbarium-mcp"
timeout: 120
connect_timeout: 60
env:
FIRECRAWL_API_URL: "http://localhost:3002"
FIRECRAWL_API_KEY: ""
BOTANICAL_ALLOWED_DOMAINS: "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org"
OPENHERBARIUM_TIMEOUT: "20"
```
Restart Hermes Agent after editing `~/.hermes/config.yaml`.
@@ -176,7 +181,13 @@ Hermes JSON-style snippet:
"openherbarium-mcp"
],
"timeout": 120,
"connect_timeout": 60
"connect_timeout": 60,
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
}
@@ -199,8 +210,20 @@ Generic `mcp.json` snippet used by many MCP clients:
}
```
If your client supports environment variables in MCP server definitions, you can
enable targeted Firecrawl search like this:
The MCP is configured through environment variables passed by the MCP client.
This lets you change endpoints and timeouts directly in `config.yaml`, `mcp.json`
or your client's MCP settings screen, without modifying the repository.
Available parameters:
| Environment variable | Required | Default | Purpose |
|---|---:|---|---|
| `FIRECRAWL_API_URL` | No | unset | Local Firecrawl base URL. Enables `search_botanical_sources` and richer source search in care/species tools. |
| `FIRECRAWL_API_KEY` | No | unset | Optional bearer token if your Firecrawl instance requires authentication. |
| `BOTANICAL_ALLOWED_DOMAINS` | No | built-in allow-list | Comma-separated source domains used to constrain targeted botanical searches. |
| `OPENHERBARIUM_TIMEOUT` | No | `20` | HTTP timeout in seconds for public APIs and Firecrawl calls. |
Generic JSON example with all configurable parameters:
```json
{
@@ -214,7 +237,9 @@ enable targeted Firecrawl search like this:
],
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": ""
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
@@ -261,6 +286,11 @@ mcp_servers:
- "openherbarium-mcp"
timeout: 120
connect_timeout: 60
env:
FIRECRAWL_API_URL: "http://localhost:3002"
FIRECRAWL_API_KEY: ""
BOTANICAL_ALLOWED_DOMAINS: "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org"
OPENHERBARIUM_TIMEOUT: "20"
```
Restart Hermes Agent. Tools will be exposed with names similar to:
@@ -272,9 +302,10 @@ Restart Hermes Agent. Tools will be exposed with names similar to:
- `mcp_openherbarium_get_image_sources`
- `mcp_openherbarium_search_botanical_sources`
## Firecrawl configuration
## `.env` fallback for manual/local runs
Copy `.env.example` to `.env` and set:
For direct local execution outside an MCP client, you can also copy `.env.example`
to `.env` and set the same parameters there:
```bash
FIRECRAWL_API_URL=http://localhost:3002
examples/claude-desktop-mcp.json
+7 -1
View File
@@ -8,7 +8,13 @@
"openherbarium-mcp"
],
"timeout": 120,
"connect_timeout": 60
"connect_timeout": 60,
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
}
examples/cursor-mcp.json
+7 -1
View File
@@ -8,7 +8,13 @@
"openherbarium-mcp"
],
"timeout": 120,
"connect_timeout": 60
"connect_timeout": 60,
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
}
examples/generic-mcp.json
+7 -1
View File
@@ -8,7 +8,13 @@
"openherbarium-mcp"
],
"timeout": 120,
"connect_timeout": 60
"connect_timeout": 60,
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
}
examples/hermes-mcp.json
+7 -1
View File
@@ -8,7 +8,13 @@
"openherbarium-mcp"
],
"timeout": 120,
"connect_timeout": 60
"connect_timeout": 60,
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
}
examples/hermes-openherbarium-uvx.yaml
+8 -4
View File
@@ -8,7 +8,11 @@ openherbarium:
- "openherbarium-mcp"
timeout: 120
connect_timeout: 60
# Optional, only needed for targeted source search:
# env:
# FIRECRAWL_API_URL: "http://localhost:3002"
# FIRECRAWL_API_KEY: ""
env:
# Optional: enable targeted botanical source search through your local Firecrawl.
FIRECRAWL_API_URL: "http://localhost:3002"
FIRECRAWL_API_KEY: ""
# Optional: tune source filtering and HTTP timeout without editing code.
BOTANICAL_ALLOWED_DOMAINS: "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org"
OPENHERBARIUM_TIMEOUT: "20"
examples/local-dev-mcp.json
+7 -1
View File
@@ -9,7 +9,13 @@
"openherbarium-mcp"
],
"timeout": 120,
"connect_timeout": 60
"connect_timeout": 60,
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
}
examples/windsurf-mcp.json
+7 -1
View File
@@ -8,7 +8,13 @@
"openherbarium-mcp"
],
"timeout": 120,
"connect_timeout": 60
"connect_timeout": 60,
"env": {
"FIRECRAWL_API_URL": "http://localhost:3002",
"FIRECRAWL_API_KEY": "",
"BOTANICAL_ALLOWED_DOMAINS": "gbif.org,powo.science.kew.org,missouribotanicalgarden.org,tela-botanica.org,inpn.mnhn.fr,rhs.org.uk,edu,wikimedia.org,wikipedia.org",
"OPENHERBARIUM_TIMEOUT": "20"
}
}
}
}