forgejo-mcp-gateway
by mitchboulay
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Log level. Logs are JSON, one line per event. | INFO |
| PUBLIC_URL | No | This gateway's public HTTPS address, which is also the OAuth issuer. Set together with SECRET_KEY to turn OAuth on. | |
| SECRET_KEY | No | At least 32 random bytes, hex or base64. Keys stored hashes and encrypts stored Forgejo tokens. Set together with PUBLIC_URL to turn OAuth on. | |
| FORGEJO_URL | Yes | How the gateway reaches Forgejo, e.g. http://forgejo:3000. | |
| DATABASE_PATH | No | Path to the SQLite database file used to keep gateway state. | /data/gateway.sqlite3 |
| OAUTH_CLIENTS | No | JSON list of {client_id, name, redirect_uris}. Clients are matched exactly and never registered dynamically. | ChatGPT |
| RATE_LIMIT_BURST | No | Burst limit for /mcp per token. | 60 |
| FORGEJO_PUBLIC_URL | No | The Forgejo address people open in a browser. Defaults to FORGEJO_URL. | |
| TOKEN_CACHE_SECONDS | No | How long a verified Forgejo token is trusted before Forgejo is asked again. | 60 |
| ALLOW_FORGEJO_TOKENS | No | Accept a Forgejo access token directly as the bearer token. | true |
| FORGEJO_MAX_ATTEMPTS | No | Maximum number of attempts for retryable Forgejo reads. | 3 |
| RATE_LIMIT_PER_MINUTE | No | Limits /mcp per token. The limit per caller address is four times higher. | 120 |
| FORGEJO_TIMEOUT_SECONDS | No | Forgejo request timeout in seconds. Reads are retried with backoff on timeouts, 429 and 5xx. Writes are never retried. | 20 |
| TRUSTED_CLIENT_IP_HEADER | No | The header your proxy sets to the caller's address, e.g. CF-Connecting-IP. Set it only when every request comes through that proxy. | |
| OAUTH_RATE_LIMIT_PER_MINUTE | No | Limits the OAuth pages and the token endpoint per caller address. | 30 |
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
ActivityMaintained
ResponsivenessNo recent community issues