FastMCP Template Servers

This repository is a small template collection for MCP servers, highlighting different features of MCP servers that can be used with Erato. Each subdirectory is an independent Python project that uses:

• uv for package management
• a local Justfile with just install and just run
• FastMCP pinned to the latest PyPI release available when this repository was scaffolded, 3.1.1 (released March 14, 2026)

Repository Layout

• api-key-server/: streamable HTTP MCP server that grants full access when the client sends the configured X-Api-Key
• oidc-id-token-server/: streamable HTTP MCP server that validates OIDC-style JWT ID tokens and authorizes access from the token's groups claim
• oauth2-keycloak-dcr-server/: streamable HTTP MCP server that publishes OAuth protected-resource metadata, validates Keycloak access tokens, and documents a local Keycloak setup for dynamic client registration plus Erato bearer-token use

All three examples expose these file tools:

• list_files: list the baked-in demo files currently visible to the caller
• get_file: read a single baked-in demo file by name

Each project ships with about ten small dummy files in code so the authentication mode changes what the user can see without depending on external storage. The Keycloak example also adds a whoami tool for inspecting validated token claims.

Common Workflow

From any project directory:

just install
just run

All projects default to FastMCP's streamable HTTP transport and are meant to be connected from Erato using an erato.toml entry similar to the examples in each project README.

For interactive local testing, you can also use the MCP Inspector. After starting a server with just run, launch the inspector against that server's streamable HTTP endpoint with:

npx @modelcontextprotocol/inspector

Then connect it to the server URL from the relevant project README, such as http://127.0.0.1:8001/mcp.