mymlh-mcp-server

一个 Model Context Protocol（MCP） 服务，可通过 OAuth 身份验证安全地访问 MyMLH。该服务可让 AI 助手和 MCP 客户端代表用户与 MyMLH API 交互。

功能

• 安全身份验证：使用 MyMLH API v4 with OAuth，实现稳健且安全的用户身份验证。
• 用户数据访问：提供工具，用于获取用户的 MyMLH 个人资料、教育经历、工作经历等。
• 自动令牌管理：自动处理令牌刷新和安全存储。
• Cloudflare Workers：构建为在边缘运行，提供低延迟、可扩展的性能。
• 轻松部署：几分钟内即可部署到你自己的 Cloudflare 账户。

快速开始

你可以使用任何支持 Streamable HTTP transport with OAuth 的 MCP 客户端连接到我们公开托管的实例。

端点：https://mymlh-mcp.git.ci/mcp

添加 MCP 服务

常见 MCP 客户端的配置示例：

VS Code：

{
  "servers": {
    "mymlh": {
      "type": "http",
      "url": "https://mymlh-mcp.git.ci/mcp"
    }
  }
}

Cursor 和许多其他客户端：

{
  "mcpServers": {
    "mymlh": {
      "url": "https://mymlh-mcp.git.ci/mcp"
    }
  }
}

Windsurf 和许多其他客户端：

{
  "mcpServers": {
    "mymlh": {
      "serverUrl": "https://mymlh-mcp.git.ci/mcp"
    }
  }
}

Augment Code：

{
  "mcpServers": {
    "mymlh": {
      "url": "https://mymlh-mcp.git.ci/mcp",
      "type": "http"
    }
  }
}

Claude Code：

claude mcp add --transport http mymlh https://mymlh-mcp.git.ci/mcp

Gemini CLI：

gemini mcp add --transport http mymlh https://mymlh-mcp.git.ci/mcp

Codex CLI：

codex mcp add mymlh --url https://mymlh-mcp.git.ci/mcp

Cline：

{
  "mcpServers": {
    "mymlh": {
      "type": "streamableHttp",
      "url": "https://mymlh-mcp.git.ci/mcp"
    }
  }
}

其他客户端：

请查阅客户端文档，了解如何连接到 MCP 服务。如果看到 401 错误，客户端可能不支持 Streamable HTTP with OAuth，你需要使用下方的备用选项。

备用选项

对于不支持 Streamable HTTP with OAuth 的环境，你可以使用 mcp-remote 回退到 stdio 传输方式。它会将 HTTP MCP 服务封装为本地 stdio 接口，并在后台通过 HTTP 转发请求，以确保兼容性。

mcp-remote 配置示例：

{
  "mcpServers": {
    "mymlh": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mymlh-mcp.git.ci/mcp"
      ]
    }
  }
}

有关用法的更多详情，请参阅 mcp-remote 文档。

可用工具

连接并完成身份验证后，你可以使用以下工具：

工具	描述
mymlh_get_user	获取当前 MyMLH 用户个人资料

使用 MCP Inspector 测试

你可以使用 Model Context Protocol Inspector 测试远程 MCP 服务。

1. 在终端中运行 Inspector：

   npx @modelcontextprotocol/inspector@latest
   

2. 输入服务 URL：https://mymlh-mcp.git.ci/mcp，然后点击“Connect”。
3. 按照身份验证流程连接并测试工具。

使用 Cloudflare AI Playground 测试

你也可以使用 Cloudflare Workers AI LLM Playground 直接测试服务。

1. 前往 Playground 链接。
2. 输入服务 URL：https://mymlh-mcp.git.ci/mcp
3. 按照身份验证流程连接并测试工具。

使用示例

你可以在 AI 助手中使用自然语言与 MyMLH MCP 服务交互：

• “获取我的 MyMLH 用户信息。”
• “显示我的 MyMLH 个人资料。”
• “使用我的 MyMLH 个人资料生成简历。”
• “使用我的 MyMLH 数据创建 GitHub 个人资料 README。”

部署自己的实例

如需完全掌控，你可以将自己的实例部署到 Cloudflare。详细说明请参阅部署指南。

参与贡献

欢迎参与贡献！无论是修复 Bug、添加功能还是改进文档，我们都非常感谢你的帮助。

有关开发环境设置、项目结构、如何添加工具以及贡献指南，请参阅 CONTRIBUTING.md。

许可证

MIT