Skip to main content
Glama
aoki-collabo

Simple Hono MCP Server

by aoki-collabo

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 - スキーマバリデーション

ライセンス

MIT

License Notice

Claude Code関連ドキュメント(.claude/.steering/等)は GenerativeAgents/claude-code-book-chapter8 を参考にしています(MIT License)。

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aoki-collabo/simple-hono-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server