modelcontextprotocol / modelcontextprotocol/python-sdk
Is one-auth-configuration-per-server a deliberate constraint?
还没有人认领这个 Issue。
- 主要语言
- Python
- 星标
- 24.3k
- 派生
- 4k
- 平均合并
- 1 天 1 小时
- 30 天内合并 PR
- 31
描述
Initial Checks
- I confirm that I'm using the newest release of my line (the latest 2.x, or the latest 1.x if I'm still on v1)
- I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue
Release line
2.x (current stable)
Description
Hi! Is one-auth-configuration-per-server in the Python SDK a deliberate constraint, or just something nobody has needed yet?
Use case
I have an MCP server for text search that enforces per-user article permissions from our main system. One deployment needs to serve two kinds of caller:
- Service-to-service (internal). Our frontend authenticates the user, the backend receives only the user's token and passes it to the MCP server — this avoids redirect-based logins between internal services. The MCP server then exchanges that token with our SSO for a token valid for a third system, so it needs a confidential client with a
client_secret. - Interactive (external). I'd like the same server to also expose a "public" entry point, so a user can add it to Claude Desktop / Codex and go through normal OAuth with a public client (PKCE, no secret).
Today AuthSettings allows exactly one configuration
issuer_urlis a singleAnyHttpUrl, and the server always publishes it as a one-element list —server/mcpserver/server.py:1207:
authorization_servers=[self.settings.auth.issuer_url]
- the client only ever reads the first entry —
client/auth/oauth2.py:349and:630, with a# todo: try all authorization_servers to find the OASM - and there is one
token_verifierperMCPServer.
The workaround, and why it doesn't hold up
The obvious approach is two MCPServer instances sharing the tool functions (see Example Code below). Stacking the decorators is fine (tool() returns the function unchanged). Mounting is where it falls apart. Both apps can't be mounted at / — the first one matches everything and the second is never reached. And once the second is mounted under a prefix, its RFC 9728 metadata route (generated from resource_server_url) is served from under that prefix:
200 /public/.well-known/oauth-protected-resource/public/mcp <- where it actually is
404 /.well-known/oauth-protected-resource/public/mcp <- where the client looks
So the second server is undiscoverable unless I re-register the well-known route at the app root by hand. That's the part that feels like it should be SDK support rather than a workaround.
Question
Is one auth config per server intentional — and if so, what's the recommended way to cover both cases? Or would you be open to multiple auth configurations / multiple token verifiers per server? Happy to put up a PR if there's interest.
Example Code
mcp = MCPServer(token_verifier=JwtTokenVerifier(),
auth=AuthSettings(resource_server_url="https://host/mcp", ...))
mcp_public = MCPServer(token_verifier=PublicJwtTokenVerifier(),
auth=AuthSettings(resource_server_url="https://host/public/mcp", ...))
@mcp.tool()
@mcp_public.tool()
async def search(...): ...
Python & MCP Python SDK
Python 3.14.2
MCP Python SDK 2.0.0
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从 server/mcpserver/server.py:1207 中的 AuthSettings 和 authorization_servers 发布开始,然后跟踪 MCPServer 上的单个 token_verifier。查看所引用行中的 client/auth/oauth2.py,以了解当前的首次进入行为及其 TODO;完成标准应是形成一项有文档记录的决定,或定义出支持两种身份验证配置的设计。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- python
- 领域
- authentication, backend-api-design
- Issue 类型
- 功能
- 难度
- 5/5
- 预计耗时
- 一周以上
- 活跃度
- 活跃
- 描述清晰度
- 基本清楚
- 新手友好度
- 35/100