HTTP Server with MCP Support

MCP 対応 HTTP サーバー

Express と TypeScript で構築された HTTP サーバーです。Web ページと Model Context Protocol（MCP）エンドポイントの両方を提供します。

特長

• Web 機能と MCP 機能の両方を備えた HTTP サーバー
• 最新の Streamable HTTP トランスポートを使用したステートレス MCP サーバーの実装
• 型安全性を確保する TypeScript
• HTTP 処理に使用する Express.js

要件

• Node.js 18+
• npm または yarn

インストール

# Clone the repository (or download)
git clone https://github.com/your-username/example-candidate-mcp-server.git
cd example-candidate-mcp-server

# Install dependencies
npm install

# Start the http transport
npm run start:web

# Start the stdio transport
npm run start

候補者データのカスタマイズ

候補者データをカスタマイズするには、環境またはプロジェクトルートの .env ファイルで、次の環境変数を設定します。

• CONTACT_EMAIL：サーバーの連絡先メールアドレス。
• MAILGUN_API_KEY：メールの送信に使用する Mailgun の API キー。
• MAILGUN_DOMAIN：メールの送信に使用する Mailgun のドメイン。
• CANDIDATE_NAME：候補者の名前。
• RESUME_URL：候補者の履歴書（PDF 形式）の URL。
• LINKEDIN_URL：候補者の LinkedIn プロフィールの URL。
• GITHUB_URL：候補者の GitHub プロフィールの URL。
• WEBSITE_URL：候補者の個人ウェブサイトの URL。

これらの変数は、サーバーの設定と、MCP サーバーが提供する候補者情報のカスタマイズに使用されます。変更を反映するには、これらの変数を変更した後、必ずサーバーを再起動してください。

src/config.ts で直接更新することもできます。

開発

# Build the TypeScript code
npm run build

# Run in development mode with auto-reloading
npm run dev

# Run tests (when added)
npm test

サーバーの構成

src/
  ├── index.ts                # Main application entry point
  ├── express.ts              # HTTP server configuration
  ├── stdio.ts                # STDIO server configuration
  ├── config.ts               # Server configuration
  └── types.ts                # TypeScript type definitions

ライセンス

ISC

fly デプロイキーの再生成

トークンは次のコマンドで作成しました。

fly tokens create deploy --name gh-jakegaylor-com-mcp-server --expiry 2160h