# simple-mcp-server

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

## 概要

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

## 提供するツール

### factorize

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

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

**出力**:
- 素因数のリスト
- 割り算回数

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

## 前提条件

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

## セットアップ

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

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

## ローカル実行

```bash
npm run dev
```

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

## テスト

```bash
npm test
```

## Cloudflareへのデプロイ

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

# デプロイ
npm run deploy
```

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

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

### Claude Desktop

`claude_desktop_config.json` に以下を追加:

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

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

### Claude Code

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

## 動作確認

curlでの確認:

```bash
# ツール一覧の取得
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](https://hono.dev/) - 軽量Webフレームワーク
- [@hono/mcp](https://github.com/honojs/middleware/tree/main/packages/mcp) - HonoのMCPサポート
- [Cloudflare Workers](https://workers.cloudflare.com/) - サーバーレス実行環境
- [Vitest](https://vitest.dev/) - テストフレームワーク
- [zod](https://zod.dev/) - スキーマバリデーション

## ライセンス

MIT

## License Notice

Claude Code関連ドキュメント（`.claude/`、`.steering/`等）は [GenerativeAgents/claude-code-book-chapter8](https://github.com/GenerativeAgents/claude-code-book-chapter8) を参考にしています（MIT License）。