Example MCP Servers

FastMCP模板服务器

此存储库是MCP服务器的一个小型模板集合，突出显示了可用于 埃拉托. 每个子目录都是一个独立的Python项目，它使用：

• uv 用于包管理
• 本地人 Justfile 随着 just install 和 just run
• FastMCP 固定到该存储库搭建时可用的最新PyPI版本， 3.1.1 （2026年3月14日发布）

仓库的规划

• api-key-server/：可流式传输的HTTP MCP服务器，当客户端发送配置的 X-Api-Key
• oidc-id-token-server/：可流式传输的HTTP MCP服务器，用于验证OIDC风格的JWT ID令牌并授权从令牌的访问 groups 声称
• oauth2-keycloak-dcr-server/：可流式传输的HTTP MCP服务器，发布OAuth保护的资源元数据，验证Keycloak访问令牌，并记录本地Keycloak设置，用于动态客户端注册和Erato承载令牌使用

这三个示例都公开了这些文件工具：

• list_files：列出调用者当前可见的内置演示文件
• get_file：按名称读取单个烘焙演示文件

每个项目在代码中都附带了大约十个小的虚拟文件，因此身份验证模式会改变用户可以看到的内容，而不依赖于外部存储。Keycloak示例还添加了 whoami 用于检查已验证令牌声明的工具。

通用工作流

从任何项目目录：

just install
just run

所有项目默认使用FastMCP的流式HTTP传输，并打算使用 erato.toml 条目类似于每个项目README中的示例。

对于交互式本地测试，您还可以使用 MCP检查员.使用启动服务器后 just run，使用以下命令对该服务器的可流式传输HTTP端点启动检查器：

npx @modelcontextprotocol/inspector

然后将其连接到相关项目README中的服务器URL，例如 http://127.0.0.1:8001/mcp.