honox-mcp-server-sample

CM-Kajiwara/honox-mcp-server-sample

3.2

If you are the rightful owner of honox-mcp-server-sample and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project is a Model Context Protocol (MCP) server built using the HonoX framework and StreamableHTTPTransport, deployable on Cloudflare Workers.

Tools

  1. add

    Adds two numbers and returns the result

HonoXとCloudflare Workersを使用したMCPサーバー

このプロジェクトは、HonoXフレームワークとStreamableHTTPTransportを使用して構築された、Cloudflare Workersにデプロイ可能なModel Context Protocol（MCP）サーバーです。

特徴

  • サンプルツール（add）を備えたMCPサーバー
  • HonoXによるシンプルなルーティングとサーバー構成
  • Cloudflare Workersへのデプロイ対応
  • TypeScriptサポート

始め方

前提条件

  • Node.js 18以上
  • npmまたはpnpm
  • Cloudflareアカウント（デプロイ用）

インストール

npm install

開発

npm run dev

これによりViteを使用して開発サーバーが起動します。

ビルド

npm run build

Cloudflare Workersへのデプロイ

npm run preview  # ローカルでのプレビュー
wrangler deploy  # 本番環境へのデプロイ

APIエンドポイント

  • ALL /mcp - MCPサーバーエンドポイント（StreamableHTTPTransportを使用）

使用方法

このサーバーは以下のサンプルツールを実装しています：

  1. add - 2つの数値を足し算して結果を返します

MCPクライアントをエンドポイントに接続して、これらのツールを利用できます。

プロジェクト構造

app/
├── routes/
│   └── mcp.ts            # MCPサーバーのルート定義
├── lib/
│   └── mcp/
│       └── server.ts     # MCPサーバー設定とツール定義
├── server.ts             # HonoXサーバー設定
tsconfig.json             # TypeScript設定
wrangler.toml             # Cloudflare Workers設定

技術スタック

  • Hono - 軽量で高速なWebフレームワーク
  • HonoX - Honoベースのフルスタックフレームワーク
  • @hono/mcp - HonoのMCP実装
  • Model Context Protocol - AIモデルとツール間の標準通信プロトコル
  • Cloudflare Workers - エッジコンピューティングプラットフォーム

ライセンス

ISC