mcpField
M
MCP OAuth Connect

MCP OAuth Connect

远程服务
gfbytes.com开发工具06 周前更新
代码仓库访问官网

关于 MCP OAuth Connect

MCP OAuth Connect 提供用于检查远程 MCP 服务 OAuth 发现配置的命令行工具、插件和技能，面向排查连接器无法连接问题的开发者。它检查登录质询、注册端点、PKCE S256 和受保护资源元数据，但不执行完整握手或工具调用。

主要功能

  1. 01检查 OAuth 登录质询
  2. 02检测客户端注册端点
  3. 03验证 PKCE S256 配置
  4. 04检查 RFC 9728 资源元数据
  5. 05输出 JSON 诊断报告

适用场景

  1. 01排查 MCP 服务在连接器中无法连接
  2. 02检查 OAuth 发现配置是否完整
  3. 03将诊断集成到命令行流程

MCP 相关

项目包含一个仅响应 ping 的参考 MCP 服务；主要诊断工具检查远程服务的发现元数据，不会获取令牌或调用 tools/list。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.gfbytes.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

MCP OAuth Connect

tests

当 MCP 远程服务能响应 curl，却在 Claude / Cursor / Desktop / Grok Connectors 中崩溃时使用的免费检查工具。

在线检查工具check.gfbytes.com
此仓库CLI diagnose.py + 插件 / 技能
Web UImcp-gfbytes
演示 MCPhttps://mcp.gfbytes.com

这是 GFB 实验室项目的一部分。创始人 / 同行身份：gregfredabytes.com · 文章 · 我在运行什么

诊断输出

本项目不是什么

  • 不是托管式 MCP 产品。 https://mcp.gfbytes.com 是仅提供 ping 的参考服务。
  • 不是已完成的握手。 检查工具会读取发现元数据，但不会执行 DCR、生成令牌或调用 tools/list。检查失败只是范围界定信号，并非终点。
  • 不是付费的接入实验室。 四客户端尝试 + 书面方案请见工作室产品页面。

只需在 Connectors UI 中粘贴URL，无需 API 密钥。

克隆 / 运行

Python 标准库，版本 ≥3.10。检查工具无需安装：

git clone https://github.com/GFB2026/mcp-oauth-connect.git
cd mcp-oauth-connect
python skills/mcp-oauth-connect/scripts/diagnose.py https://mcp.gfbytes.com

如果连接器关键检查通过，则退出码为 0；否则为 1。JSON 报告输出到 stdout。

检查是否提供了规范的登录质询（而非 curl 返回的裸 200）、注册端点、PKCE S256，以及 RFC 9728 受保护资源元数据。

测试：

python -m pip install "pytest>=8"
python -m pytest

面向 AI 助手 / 贡献者

编辑范围和硬性限制：.github/copilot-instructions.md。 使用 python -m pytest 验证（安装 pytest>=8；此代码树采用扁平结构，无需 pip install -e）。

插件安装（可选）

Claude Code：

/plugin marketplace add GFB2026/mcp-oauth-connect
/plugin install mcp-oauth-connect@mcp-oauth-connect

Grok Build：

grok plugin marketplace add GFB2026/mcp-oauth-connect
grok plugin install mcp-oauth-connect --trust

然后运行与上文相同的 diagnose.py。

template/

位于 https://mcp.gfbytes.com 后的公开示例，仅提供 ping（MIT）。这是参考服务，不是服务 SKU。

许可证

插件、技能、诊断脚本、测试和 template/ 采用 MIT 许可证。工作室的接入实验室 / 修复服务是 gfbytes.com 上的独立服务。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。