mymlh-mcp-server

Model Context Protocol (MCP) サーバーです。MyMLH への安全な OAuth 認証アクセスを提供します。このサーバーを使用すると、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 に独自のインスタンスをデプロイできます。詳しい手順については、デプロイガイドをご覧ください。

コントリビューション

コントリビューションを歓迎します！バグの修正、機能の追加、ドキュメントの改善など、皆さまのご協力に感謝します。

開発環境のセットアップ、プロジェクト構成、ツールの追加方法、コントリビューションのガイドラインについては、CONTRIBUTING.mdをご覧ください。

ライセンス

MIT