mcp-think

Cloudflare Workers上で構築された、構造化された逐次思考のためのリモートMCPサーバー。

アーキテクチャ

• Cloudflare Worker が /mcp をStreamable HTTP経由で公開します。

• MCP SDK v2 がツールを定義します。

• Durable Objects + SQLite が各シーケンスを永続化します。

• シーケンスは明示的な sequenceId で識別されます。MCPプロトコルセッションはアプリケーション状態を保持しません。

この設計は現在のCloudflareのガイドラインに従っています。新しいMCPサーバーはv2/ステートレスハンドラーを使用し、マルチステップワークフローのアプリケーション状態は明示的なDurable Object境界の背後に置かれます。McpAgent は非推奨であり、ここでは意図的に使用されていません。

Related MCP server: handoff-mcp

ツール

start_sequence

シーケンスを作成し、sequenceId を返します。

add_step

構造化されたステップを追加します。要約、仮定、証拠、仮説、決定に使用します。このサーバーは隠れた思考過程（chain-of-thought）を公開または保存することを意図していません。

revise_step

元のレコードを保持したまま、以前のステップの新しいリビジョンを作成します。

get_sequence

シーケンスのメタデータと保存されたすべてのステップを返します。

finish_sequence

最終的な結論を保存し、シーケンスを完了としてマークします。

reset_sequence

保存されたシーケンスデータを削除します。

ローカル開発

npm install
npm run typecheck
npm run dev

ローカルMCPエンドポイントは次のとおりです：

http://localhost:8787/mcp

ヘルスチェック：

http://localhost:8787/health

デプロイ

CloudflareアカウントでWranglerを認証し、次を実行します：

npm run deploy

Cloudflareは wrangler.jsonc のマイグレーションからSQLiteを利用したDurable Objectを自動的にプロビジョニングします。

使用例

start_sequence(goal)
      ↓
sequenceId
      ↓
add_step(sequenceId, ...)
      ↓
add_step(sequenceId, ...)
      ↓
revise_step(sequenceId, stepId, ...)
      ↓
get_sequence(sequenceId)
      ↓
finish_sequence(sequenceId, conclusion)

セキュリティロードマップ

MVPには意図的に認証が含まれていません。エンドポイントを公開する前に、OAuthまたはその他の認証レイヤーを追加し、シーケンスの所有権を認証済みプリンシパルにバインドしてください。CloudflareのMCPガイダンスでは、CORSを認証メカニズムとして扱うのではなく、明示的なHost/Originの検証と認証を推奨しています。