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

-
security - not tested
F
license - not found
-
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