ci.git/mymlh-mcp-server
OAuth-enabled MyMLH MCP server for accessing MyMLH data.
Open source Repository Open in the app JSON README (API)
About
OAuth-enabled MyMLH MCP server for accessing MyMLH data.
Details
- Kind
- MCP servers
- Topic
- Security & identity
- Publisher
- ci.git
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 10
- Forks
- 2
- Open pull requests
- 5
- Last push
- 2026-07-30T21:00:05Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-29 03:00:49
- Updated
- 2026-08-29 03:00:49
- Origin id
ci.git/mymlh-mcp-server
README
[](https://modelcontextprotocol.io/specification/2026-07-28/basic/transports)
[](https://www.mlh.com/)
[](https://developers.cloudflare.com/workers/)
[](https://www.typescriptlang.org/)
[](https://hono.dev/)
[](https://wei.mit-license.org)
[](https://github.com/wei/mymlh-mcp-server/actions/workflows/ci.yml)
A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/2026-07-28/getting-started/intro) server that provides secure, OAuth-authenticated access to [MyMLH](https://www.mlh.com/). 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](https://www.mlh.com/developers/docs) 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](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization).
**Endpoint**: `https://mymlh-mcp.git.ci/mcp`
### Add MCP Server
[](https://insiders.vscode.dev/redirect/mcp/install?name=mymlh&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmymlh-mcp.git.ci%2Fmcp%22%7D)
[](https://cursor.com/en/install-mcp?name=mymlh&config=eyJ1cmwiOiJodHRwczovL215bWxoLW1jcC5naXQuY2kvbWNwIn0%3D)
Example configuration snippets for common MCP clients:
**VS Code:**
```json
{
"servers": {
"mymlh": {
"type": "http",
"url": "https://mymlh-mcp.git.ci/mcp"
}
}
}
```
**Cursor and many clients:**
```json
{
"mcpServers": {
"mymlh": {
"url": "https://mymlh-mcp.git.ci/mcp"
}
}
}
```
**Windsurf and many clients:**
```json
{
"mcpServers": {
"mymlh": {
"serverUrl": "https://mymlh-mcp.git.ci/mcp"
}
}
}
```
**Augment Code:**
```json
{
"mcpServers": {
"mymlh": {
"url": "https://mymlh-mcp.git.ci/mcp",
"type": "http"
}
}
}
```
**Claude Code:**
```sh
claude mcp add --transport http mymlh https://mymlh-mcp.git.ci/mcp
```
**Gemini CLI:**
```sh
gemini mcp add --transport http mymlh https://mymlh-mcp.git.ci/mcp
```
**Codex CLI:**
```sh
codex mcp add mymlh --url https://mymlh-mcp.git.ci/mcp
```
**Cline:**
```json
{
"mcpServers": {
"mymlh": {
"type": "streamableHttp",
"url": "https://mymlh-mcp.git.ci/mcp"
}
}
}
```
**Other clients:**
Consult your client's documentation for connecting to an MCP server. If you see 401 errors, the client likely does not support [Streamable HTTP with OAuth](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization) 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`](https://www.npmjs.com/package/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:
```json
{
"mcpServers": {
"mymlh": {
"command": "npx",
"args": [
"mcp-remote",
"https://mymlh-mcp.git.ci/mcp"
]
}
}
}
```
See [`mcp-remote` documentation](https://www.npmjs.com/package/mcp-remote#usage) 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 |
### Test with MCP Inspector
You can test the remote MCP server using the [Model Context Protocol Inspector](https://modelcontextprotocol.io/docs/tools/inspector).
1. Run the Inspector from your terminal:
```bash
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](https://playground.ai.cloudflare.com/).
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](DEPLOYMENT.md) 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](CONTRIBUTING.md).
## License
[MIT](https://wei.mit-license.org)