simple-mcp-server

CloudflareとHonoで作る最もシンプルなリモートMCPサーバー。

概要

このプロジェクトは、MCP (Model Context Protocol) サーバーをCloudflare Workers上で動作させるサンプル実装です。Honoフレームワークを使用し、最小限のコードでMCPサーバーを構築できることを示しています。

提供するツール

factorize

正の整数を素因数分解するツールです。

入力:

number: 素因数分解する正の整数（1以上、15桁以下）

出力:

素因数のリスト
割り算回数

例:

入力: 12
出力: 12の素因数分解結果:
素因数: [2, 2, 3]
割り算回数: 3回

前提条件

Node.js v18以上
Cloudflareアカウント（デプロイする場合）

セットアップ

# リポジトリのクローン
git clone <repository-url>
cd simple-mcp-server

# 依存関係のインストール
npm install

ローカル実行

npm run dev

サーバーが http://localhost:8787 で起動します。MCPエンドポイントは http://localhost:8787/mcp です。

テスト

npm test

Cloudflareへのデプロイ

# Cloudflareにログイン（初回のみ）
npx wrangler login

# デプロイ
npm run deploy

デプロイ後、https://<your-worker>.workers.dev/mcp でアクセスできます。

MCPクライアントからの接続

Claude Desktop

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "simple-mcp-server": {
      "url": "http://localhost:8787/mcp"
    }
  }
}

デプロイ後は url をCloudflare WorkersのURLに変更してください。

Claude Code

claude mcp add simple-mcp-server http://localhost:8787/mcp --transport http

動作確認

curlでの確認:

# ツール一覧の取得
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

# 素因数分解の実行
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "factorize", "arguments": {"number": 12}}, "id": 2}'

技術スタック

Hono - 軽量Webフレームワーク
@hono/mcp - HonoのMCPサポート
Cloudflare Workers - サーバーレス実行環境
Vitest - テストフレームワーク
zod - スキーマバリデーション

simple-hono-mcp-server