Hono MCP Sample Server

Honoフレームワークとhono/mcpを使用したModel Context Protocol (MCP) サーバーのサンプル実装です。

機能

このサンプルサーバーは以下のMCP機能を提供します：

リソース

• weather://tokyo: 東京の天気情報を取得
• news://latest: 最新ニュースヘッドラインを取得

ツール

• calculator: 2つの数値を加算
  • パラメータ: a (number), b (number)
• reverse-string: 文字列を反転
  • パラメータ: text (string)

プロンプト

• code-review: コードレビューを依頼するプロンプトテンプレート
  • 引数: code (string)

セットアップ

依存関係のインストール

npm install

使用方法

開発モード

npm run dev

ビルド

npm run build

本番環境で実行

npm start

エンドポイント

サーバーが起動すると、以下のエンドポイントが利用可能になります：

• http://localhost:3000/ - サーバー情報
• http://localhost:3000/mcp - MCPエンドポイント

技術スタック

• Hono: 高速で軽量なWebフレームワーク
• hono/mcp: HonoのMCPサポートパッケージ
• @modelcontextprotocol/sdk: MCP公式SDK
• zod: スキーマ定義（v3系を使用）
• TypeScript: 型安全な開発
• tsx: TypeScriptの実行環境

構成

mcp-sample/
├── src/
│   └── index.ts       # メインサーバーファイル
├── package.json       # プロジェクト設定
├── tsconfig.json      # TypeScript設定
└── README.md          # このファイル

カスタマイズ

新しいリソースを追加

mcpServer.registerResource(
    "custom resource",
    new ResourceTemplate("custom://resource", { list: undefined }),
    {
        description: "リソースの説明",
        mimeType: "text/plain",
    },
    async (uri) => ({
        contents: [
            {
                url: uri.href,
                mimeType: "text/plain",
                text: "リソースの内容",
            },
        ],
    }),
);

新しいツールを追加

mcpServer.registerTool(
    "custom-tool",
    {
        description: "ツールの説明",
        inputSchema: {
            param1: z.string().describe("パラメータの説明"),
        },
    },
    async ({ param1 }) => {
        const result = a + b;
        return {
            content: [
                {
                    type: "text",
                    text: `処理結果: ${param1}`,
                },
            ],
        };
    },
);

ライセンス

MIT