AMIRA MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | HTTP bind address; set 0.0.0.0 explicitly for remote access. The Docker image sets this itself. | 127.0.0.1 |
| PORT | No | Port for the remote HTTP transport (server/http.js); ignored by the .mcpb. | 8787 |
| AMIRA_SKILLS | No | Serve the companion skill over the finalized SEP-2640 extension. 0/false/off withdraws the capability and the skills/* methods. | on |
| AMIRA_DATA_DIR | No | Override the bundled snapshot path (dev). | bundled data/ |
| AMIRA_EXPOSURE | No | Benchmark experiments only: restrict which metadata the tools expose (minimal, descriptive, structured, full). | full |
| AMIRA_CACHE_DIR | No | Refreshed-data cache directory: where refreshed snapshots are stored. | ~/.amira-mcp/cache |
| AMIRA_SITE_BASE | No | Site base URL (advanced): base for citations + refresh (AMIRA_DASHBOARD_BASE is honoured with a deprecation warning). | https://data.africamultiple.uni-bayreuth.de |
| AMIRA_SITE_SLUG | No | Omeka site slug used in amira_url. | amira |
| AMIRA_PROXY_HOPS | No | Number of trusted proxies in front of the server, for reading X-Forwarded-For when X-Real-IP is absent. IPv6 clients are bucketed by /64. | 1 |
| AMIRA_RATE_LIMIT | No | Requests/minute per client on /mcp (0 disables). A courtesy cap — queries operate on the in-memory snapshot — not a security control; /healthz is exempt. | 120 |
| AMIRA_TRUST_PROXY | No | Attribute requests to the address the reverse proxy observed: X-Real-IP, otherwise the X-Forwarded-For entry AMIRA_PROXY_HOPS from the right (never the client-supplied leftmost one). Enable it behind a proxy — otherwise every request comes from the proxy and all clients share one bucket — and never when clients connect directly. | false |
| AMIRA_LIVE_REFRESH | No | Probe + refresh the snapshot from the public API at startup and on the periodic interval. | true |
| AMIRA_TOOL_PROFILE | No | full, research, discovery, or visualization; restart to change. | full |
| AMIRA_ALLOWED_ORIGINS | No | Comma-separated browser Origin hostnames or URLs allowed to call the HTTP endpoint. Server-to-server clients, which omit Origin, are unaffected. Add trusted web-client origins explicitly; wildcards are rejected. | localhost, 127.0.0.1, [::1] |
| AMIRA_FULL_REFRESH_HOURS | No | Force a complete crawl after this snapshot age even if item signatures are unchanged; minimum 1 hour. | 168 |
| AMIRA_REFRESH_INTERVAL_HOURS | No | When live refresh is on, repeat the freshness probe this often while the server is running; set 0 to disable periodic checks. | 24 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessSlow