mymlh-mcp-server

A Model Context Protocol (MCP) server that provides secure, OAuth-authenticated access to MyMLH. This server enables AI assistants and MCP clients to interact with the MyMLH API on behalf of users.

Features

• Secure Authentication: Implements MyMLH API v4 with OAuth for robust and secure user authentication.
• User Data Access: Provides tools to fetch a user's MyMLH profile, education, employment history, and more.
• Automatic Token Management: Handles token refresh and secure storage automatically.
• Cloudflare Workers: Built to run on the edge for low-latency, scalable performance.
• Easy Deployment: Can be deployed to your own Cloudflare account in minutes.

Quick Start

You can connect to our publicly hosted instance using any MCP client that supports the Streamable HTTP transport with OAuth.

Endpoint: https://mymlh-mcp.git.ci/mcp

Add MCP Server

Example configuration snippets for common MCP clients:

VS Code:

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

Cursor and many clients:

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

Windsurf and many clients:

{
  "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 currently only supports the deprecated SSE protocol.

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

Roo Code, Cline, KiloCode:

Although these clients support Streamable HTTP transport, they do not yet support the OAuth authentication flow. Please use the fallback option below. See open feature requests for Roo Code, Cline.

For other clients, please consult their documentation for connecting to an MCP server. If you see 401 errors, the client likely does not support Streamable HTTP with OAuth and you will need to use the fallback option below.

Fallback Option

For environments where Streamable HTTP with OAuth is not supported, you may fall back to stdio transport with mcp-remote. This wraps the HTTP MCP server into a local stdio interface, forwarding requests over HTTP behind the scenes to ensure compatibility.

Example mcp-remote configuration snippet:

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

See mcp-remote documentation for more details on usage.

Available Tools

Once connected and authenticated, you can use the following tools:

Tool	Description
mymlh_get_user	Fetch current MyMLH user profile
mymlh_get_token	Return current MyMLH access token details
mymlh_refresh_token	Exchange MyMLH refresh_token for a new access token and persist it

Test with MCP Inspector

You can test the remote MCP server using the Model Context Protocol Inspector.

1. Run the Inspector from your terminal:

   npx @modelcontextprotocol/inspector@latest
   

2. Enter the server URL: https://mymlh-mcp.git.ci/mcp and click "Connect".
3. Follow the authentication flow to connect and test the tools.

Testing with Cloudflare AI Playground

You can also test the server directly using the Cloudflare Workers AI LLM Playground.

1. Go to the playground link.
2. Enter the server URL: https://mymlh-mcp.git.ci/mcp
3. Follow the authentication flow to connect and test the tools.

Example Usage

You can interact with the MyMLH MCP server using natural language in your AI assistant:

• "Get my MyMLH user info."
• "Show me my MyMLH profile."
• "Generate a resume using my MyMLH profile."
• "Create a GitHub profile README using my MyMLH data."

Deploying Your Own Instance

For full control, you can deploy your own instance to Cloudflare. See the Deployment Guide for detailed instructions.

Contributing

We welcome contributions! Whether you're fixing a bug, adding a feature, or improving documentation, your help is appreciated.

For development setup, project structure, how to add tools, and contributing guidelines, see CONTRIBUTING.md.

License

MIT