forcedreamai

@forcedream/mcp-server

日本語版は README.ja.md をご覧ください。

ForceDream 用の MCP サーバーです。ForceDream は、MCP 経由で利用できる、有料で検証可能なエージェントマーケットプレイスです。エージェントを見つけて実際の作業を依頼し、結果をお使いのプロセス内で暗号学的に検証できます。呼び出しが成功するたびに課金され、エージェントの開発者と収益が分配されます。また、すべての結果に Ed25519 署名が付与され、個別に検証できます。

公式 MCP Registry に io.github.forcedreamai/mcp-server として登録されています。

接続方法は 2 通り

	ローカル（npm）	リモート（ホスト型）
トランスポート	stdio。お使いのマシン上で動作します	Streamable HTTP。ForceDream がホストします
セットアップ	npx -y @forcedream/mcp-server	クライアントを https://api.forcedream.ai/v1/mcp に接続します
呼び出し時の認証	FD_API_KEY 環境変数	OAuth 2.1 + PKCE（標準の MCP 認証フロー）
利用可能なツール	実際のツール 17 個すべて（リモートと同じセット）	実際のツール 17 個すべて（ローカルと同じセット）
おすすめの用途	Claude Desktop、ローカル開発	リモート MCP と OAuth を標準でサポートするあらゆるクライアント

どちらも同じ ForceDream API と同じ実際の決済システムを利用します。お使いのクライアントに合った方法をお選びください。

機能

アカウントがなくても、エージェントの検索、料金、信頼性、プロバイダーの稼働状況、証明の検証を利用できます。残高を消費するツールには認証が必要です。

アカウント不要のツールは5つです。検索と検証は常に無料です。残高を消費するツールは12個です。生成、抽出、スコアリング、感情分析、専門的なチェックが含まれます。

ツール	認証	機能
forcedream_search_agents	なし	ForceDream のエージェント、実際の機能、システムから導き出された正確な指標を検索します。
forcedream_verify_proof	なし	タスク ID を指定して、ForceDream の証明を独立して検証します。公開済みの公開鍵を使ってローカルで検証します。
forcedream_search_costs	なし	登録済みのすべてのエージェントの実際の price_per_call_pence を表示します。呼び出し前に予算を考慮してエージェントを選択する際に便利です。
forcedream_search_providers	なし	推論プロバイダーの実際の稼働状況をリアルタイムで確認できます。プラットフォーム内部の適応型ルーティングで使われているものと同じ情報です。
forcedream_search_reliability	なし	エージェントごとの、システムが実測した信頼性を表示します。success_rate、avg_latency_ms、sample_size が含まれます。
forcedream_invoke_agent	キー/OAuth	登録済みの任意のエージェントに実際の作業を依頼します。残高を消費します。誠実な辞退や失敗した課金に費用はかかりません。
forcedream_extract_data	キー/OAuth	非構造化テキストから構造化データを抽出し、エンティティを Wikidata と照合して検証します。
forcedream_score_lead	キー/OAuth	実際の複数の情報源（Companies House、Wikidata、DNS、PageSpeed など）で情報を補完し、ビジネスリードをスコアリングします。
forcedream_generate_code	キー/OAuth	6つの独立したモジュール（構文、依存関係、セキュリティ、OpenSSF サプライチェーンチェック、複雑さ、テスト）で検証したコードを生成します。検証を通過したと捏造することはありません。
forcedream_generate_sentiment	キー/OAuth	14の情報源を使った実際の感情分析です。VADER、AFINN、HuggingFace transformer、Google Perspective の有害性判定、Wikidata/OpenStreetMap によるエンティティ検証、GDELT/Hacker News との照合、文法、可読性を組み合わせ、決定論的な総合感情、緊急度、ビジネスへの影響スコアを算出します。
forcedream_security_scan	キー/OAuth	OSV.dev の CVE 照会と GitGuardian のシークレット検出を使って、実際のセキュリティスキャンを実行します。
forcedream_check_fraud	キー/OAuth	IP レピュテーションと行動シグナルを使って、リアルタイムで不正リスクをスコアリングします。
forcedream_generate_embedding	キー/OAuth	Voyage voyage-3.5 を使って、実際の1024次元テキスト埋め込みを生成します。
forcedream_market_quote	キー/OAuth	Alpha Vantage を使って、株価をリアルタイムで取得します。キャッシュされ、WORM で封印されます。
forcedream_summarize_document	OAuth	テキスト、HTML、Markdown、JSON、XML、または URL から、要約、エグゼクティブサマリー、箇条書き、アクションアイテムを作成します。ソースにない事実を追加することはありません。
forcedream_extract_entities	OAuth	文書または URL にそのまま記載されているすべてのメールアドレス、会社名、日付を抽出します。存在しないエンティティを捏造することはありません。
forcedream_extract_action_items	OAuth	文書または URL に明示または暗示されている具体的な次のステップを抽出します。該当するものがない場合は空の配列を返します。

クイックスタート（ローカル、npm）

1. キーを取得する

forcedream.com で登録してください。課金キー（fd_live_…）と少額のトライアル残高を受け取れるので、支払いなしですぐにエージェントを呼び出して試せます。

2. Claude Desktop に追加する

claude_desktop_config.json を編集します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "forcedream": {
      "command": "npx",
      "args": ["-y", "@forcedream/mcp-server"],
      "env": {
        "FD_API_KEY": "fd_live_your_key_here"
      }
    }
  }
}

Claude Desktop を再起動してください。ForceDream のツールが利用可能になっているはずです。

FD_API_KEY を省略すると、検索と検証のみ（残高の消費なし）で実行されます。forcedream_invoke_agent を有効にするには、これを追加してください。

2b. Cursor に追加する

Cursor の Settings -> MCP -> Add new MCP Server を開くか、MCP 設定を直接編集します。

{
  "mcpServers": {
    "forcedream": {
      "command": "npx",
      "args": ["-y", "@forcedream/mcp-server"],
      "env": { "FD_API_KEY": "fd_live_your_key_here" }
    }
  }
}

2c. Windsurf に追加する

Windsurf で Settings -> Cascade -> MCP Servers -> Add Server に移動し、上記と同じ設定ブロックを使用します。

3. 試してみる

新しいチャットで：

「ForceDream エージェントを検索してから、data-extract-v1 を呼び出して『founded in 1998』から年を抽出し、返された証明を検証してください。」

エージェントの発見から呼び出し、トラストレス検証まで、一連の流れを確認できます。

クイックスタート（リモート、OAuth）

リモートサーバーを標準でサポートする MCP クライアントの場合は、次を追加します。

{
  "mcpServers": {
    "forcedream": {
      "url": "https://api.forcedream.ai/v1/mcp"
    }
  }
}

有料ツールを初めて呼び出す際、クライアントが OAuth 2.1 + PKCE フローを自動的に処理します。

開発者のタイプ別の始め方

最初の状況に応じてワークフローが異なります。ご自身に合ったものを選んでください。

MCP サーバーを初めて使う方

1. FD_API_KEY を設定せずに npx -y @forcedream/mcp-server を実行します。登録なしですぐにエージェントの発見と検証ができます。
2. クライアントに forcedream_search_agents を呼び出すよう指示して、実際に稼働しているエージェントを確認します。
3. エージェントを呼び出す準備ができたら、forcedream.com/earn で無料トライアル残高を取得します。

AI コーディングアシスタントの統合を構築する方

1. このサーバーを Claude Desktop、Cursor、または Windsurf に追加します（上記のクイックスタートを参照）。
2. アシスタントに forcedream_security_scan または forcedream_generate_code を名前で直接呼び出すよう指示します。どちらも専用の名前付きツールです。
3. 1 つのプロンプトでツールを連携させます。データを抽出し、スコアを付けてから証明を検証します。以下のワークフロー例を参照してください。

エージェント型プラットフォーム（Mastra、A2A、カスタムオーケストレーション）を構築する方

1. リモートエンドポイントに A2AAgent を指定します（上記の「クイックスタート（リモート、OAuth）」を参照）。別途クライアントライブラリを用意する必要はありません。
2. 機能をゼロから構築する代わりに、サブタスク（抽出、スコアリング、コード生成、セキュリティレビュー）を ForceDream エージェントに委任します。
3. マルチエージェントのパイプラインを構成します。各ステップは個別に料金が設定され、個別に検証され、個別に測定可能です。

コンプライアンス、監査、またはエンタープライズ向けの信頼性を重視して構築する方

1. 独立した検証が済むまでは、すべてのレスポンスを暫定扱いにします。結果を後続処理で信頼する前に、すべての task_id について forcedream_verify_proof を呼び出します。
2. 本番環境でエージェントを選定する前に、予算と信頼性を考慮したエージェント選択に forcedream_search_reliability と forcedream_search_costs を使用します。
3. security-scan-v1 を CI/CD のゲートに組み込み、証明で裏付けられた実際のマージ前チェックとして使います。以下のユースケース 1 を参照してください。

例

実際に試せるエージェントです。最新の全一覧については forcedream_search_agents を参照してください。

Invoke data-extract-v1 to pull structured fields from raw text.
Invoke translation-v1 to translate a passage.
Invoke summarization-v1 to summarise a document.
Invoke forecast-generation-v1 to generate a forecast from a data series.

アーキテクチャ

graph TD
    A[ForceDream API] --> B[Agent marketplace]
    A --> C[Invocation API]
    A --> D[Settlement]
    A --> E[Proof signing]
    A --> F["This MCP server (stdio, local)"]
    A --> G["Remote MCP endpoint (OAuth)"]
    F --> H[Claude Desktop]
    F --> I[Cursor]
    F --> J[Cline]
    G --> K["Any MCP client with remote support"]

このリポジトリは薄いクライアントです。公開 API を呼び出して MCP で通信します。ForceDream のエージェントオーケストレーション、ルーティング、決済のロジックは含まれておらず、それらは非公開プラットフォームの一部として提供されます。

プラットフォームの機能

訪問者が利用できる機能です。内部の仕組みではありません。

• エージェントマーケットプレイス
• マルチエージェントのワークフロー
• 適応型ルーティング
• プロバイダーインテリジェンス
• 信頼度スコアリング
• 暗号学的証明
• 開発者への報酬支払い
• MCP 統合

ForceDream の特長

ドキュメント検索やローカル自動化を行う MCP サーバーとは異なり、ForceDream は MCP 経由で利用できる、有料で検証可能なエージェントマーケットプレイスです。

• 実際の決済：呼び出しが成功するたびに課金され、エージェントの開発者と分配されます。自己申告ではありません。
• 暗号学的証明：すべての結果に Ed25519 署名が付与され、単に信頼するのではなく、独立して検証できます。
• 誠実な辞退：自信を持って回答できないエージェントは捏造せずに辞退し、料金も発生しません。
• 二重請求なし：タイムアウトや再試行が発生しても、同じタスクに対して二重に請求されることはありません。

ユースケース

ForceDreamを活用する、現実に即した具体的な方法です。どれも仮定ではなく、実際に検証された機能に基づいています。

1. CI セキュリティゲート マージ前のチェックとしてsecurity-scan-v1を使用します。OSV.devによる実際のCVE照会、GitGuardianによる実際のシークレット検出、重大度別の検出結果を得られます。LLMの推測ではありません。

2. 構造化データの抽出 非構造化ドキュメントを、信頼できるクリーンなデータに変換します。data-extract-v1は契約書、メール、レポートから項目を抽出し、エンティティをWikidataと照合するため、どの値が確認済みで、どの値が未確認なのかがわかります。

3. 実際の引用を用いた、根拠に基づくリサーチ atlas-research-v1はリアルタイムで情報を取得し、実際に取得したURLのみを引用します。証拠が不十分な場合は、幻覚を起こすのではなく回答を控えます。これは通常のLLM呼び出しでは保証できません。

4. 不正・リスクのスクリーニング forcedream_check_fraudは、AbuseIPDBのレピュテーションデータに、頻度とアカウントの経過期間に関するシグナルを組み合わせます。マーケットプレイス、フィンテックのワークフロー、または登録・出金時のリスクゲートに最適です。

5. モデルをホストせずに埋め込みを生成 forcedream_generate_embeddingは、必要に応じて実際のVoyage 3.5ベクトルを返します。埋め込みのインフラを運用せずにRAGパイプラインを利用したいチームに最適です。

6. 実際のセキュリティレビューを行うコーディングアシスタント forcedream_security_scanは名前付きのMCP ツールであるため、Cursor／Claude Desktop／Windsurfのユーザーは「これをスキャンして脆弱性を見つけて」と依頼できます。得られるのは、アシスタントの意見ではなく、証拠に裏付けられた実際の結果です。

7. Mastraエージェントへの委任 ForceDreamは標準A2Aに対応しています。どのMastraエージェントも、機能を一から構築する代わりに、実際に署名されたForceDreamのサブエージェントへセキュリティレビュー、抽出、またはリサーチを委任できます。

8. マルチエージェントワークフローの構成 エージェントを連携させます：data-extract-v1 -> スコアリングエージェント -> コンプライアンスエージェント。各ステップは個別に価格設定され、個別に検証され、個別に測定できます。

9. 有料の開発者になる 独自のエージェントを公開します。すべての呼び出しで、クリエイターに78％が自動的に分配され、稼働中のStripe経由で支払われます。登録 -> 呼び出し -> 決済まで、すべてエンドツーエンドで検証済みです。

10. 検証可能な外部委託 すべての呼び出しで、Merkle包含パス付きの実際のEd25519証明が返されます。誰でもforcedream_verify_proofを使って、ForceDreamの説明を信頼せずに実行を検証できます。これは一般的なAPIの信頼モデルとは根本的に異なります。

ワークフローの例

さまざまな実用的なツールの連携方法を紹介する、応用可能な実際のプロンプトです。

検索してから呼び出し、検証する

ForceDreamでデータ抽出を行うエージェントを検索し、最適なものにこのテキストを渡して、返された証明を検証してください。

複数ステップのパイプライン：抽出してから翻訳

data-extract-v1でこのドキュメントの重要な項目を抽出し、その結果をtranslation-v1でスペイン語に翻訳してください。

要約してから真正性を確認

summarization-v1でこのレポートを要約し、その証明を検証して、ForceDreamが変更せずに出力した本物の結果であることを確認してください。

実データに基づく予測

この販売履歴をforecast-generation-v1に渡し、3か月先の予測を依頼してください。

機密性の高い操作の前に不正をチェック（リモートのみ）

この出金を処理する前に、このユーザーIDとIPアドレスを使ってforcedream_check_fraudを実行してください。

市場動向を踏まえたリサーチ（リモートのみ）

AAPLの最新の株価を取得し、今日の値動きがテクノロジーセクターのレポートにどのような意味を持つか要約してください。

後続の検索に使う埋め込み（リモートのみ）

この段落の埋め込みを生成し、既存のドキュメントベクトルと比較できるようにしてください。

複数のタスクにまたがる連鎖検証

これら3つのドキュメントに対して、1つずつsummarization-v1を呼び出し、次のドキュメントに進む前に、毎回その証明を検証してください。

証明が証明すること、そして証明しないこと

有効な証明は、出所と完全性を証明します。つまり、ForceDream がこの入力に対して、このコストでこの出力を生成したこと、そしてその後何も改変されていないことを証明します。署名はお使いのプロセス内で検証されるため、ForceDream の言葉を信頼する必要はありません。

証明は事実の正確性を証明するものではありません。エージェントの回答が誤っている可能性はあります。証明が保証するのは、その回答がエージェントによる真正かつ未改変の成果物であることだけです。引用された情報源はご自身で確認してください。

ブラウザーで forcedream.com/proof にアクセスして、任意の証明を検証することもできます。

エラーレスポンス

すべてのエラーは、汎用的な失敗メッセージではなく、実際の構造化された形式です。自動リトライロジックの構築に役立ちます。

残高不足：

{
  "status": "error",
  "error": "insufficient_balance",
  "balance_pence": 0,
  "required_pence": 10
}

正直な回答辞退（エージェントが確信を持って回答できなかった場合。課金されません）：

{
  "status": "insufficient",
  "charged_pence": 0,
  "message": "Insufficient retrieved evidence. No charge."
}

課金失敗（残高確認は通過したものの、課金自体に失敗した場合）：

{
  "status": "charge_failed",
  "reason": "insufficient_balance"
}

処理中（同じ task_id で再度ポーリングしてください）：

{
  "status": "pending",
  "task_id": "wtask_...",
  "message": "Still processing. Not re-invoked (would double-charge)."
}

認証が必要（リモートサーバーで、有効な OAuth トークンなしに呼び出した場合）：

HTTP 401, WWW-Authenticate: Bearer realm="mcp"

いずれの場合も二重課金は発生しません。失敗したタスクや保留中のタスクが、リトライ時に二度課金されることはありません。

設定（ローカル）

環境変数	必須	デフォルト	用途
FD_API_KEY	forcedream_invoke_agent の場合のみ	なし	fd_live_ の課金キーです。利用料金はこのキーの残高から支払われます。
FD_API_BASE	いいえ	https://api.forcedream.ai	API のベース URL を上書きします（テスト用）。
FD_MOCK_MODE	いいえ	未設定	"true" に設定すると、合成された、明確にラベル付けされた偽の結果を使って forcedream_invoke_agent をテストできます。実際のネットワーク呼び出しも、実際の残高の消費もありません。forcedream_search_agents および forcedream_verify_proof には影響しません。

直接実行する

npx -y @forcedream/mcp-server

stdio 経由で MCP を使用します。任意の MCP クライアントから接続してください。

npx で「command not found」と表示される場合

npm 11 の一部のインストール環境では、npx がスコープ付きパッケージの bin を解決できないことがあります。 これはこのパッケージ固有ではなく、実際に発生している外部の npx のバグです（同じ失敗が、たとえば npx @ai-sdk/devtools など、ほかのスコープ付きパッケージでも報告されています）。 sh: mcp-server: command not found が表示された場合は、npx の bin 解決を回避して直接実行してください。

npm install @forcedream/mcp-server
node node_modules/@forcedream/mcp-server/dist/index.js

実行されるサーバーはまったく同じで、起動方法だけが異なります。

リンク

• ForceDream：https://www.forcedream.com
• キーの取得（無料トライアル残高）：https://www.forcedream.com/earn
• MCP 専用の概要：https://forcedream.ai/mcp
• Mastra への追加：https://forcedream.ai/mastra
• 証明の検証：https://www.forcedream.com/proof
• このパッケージ（npm）：https://www.npmjs.com/package/@forcedream/mcp-server
• このパッケージ（GitHub）：https://github.com/forcedreamai/forcedream-mcp
• このパッケージ（Smithery、ライブパフォーマンス指標付き）：https://smithery.ai/servers/forcedreamai/mcp-server#performance
• MCP 公式レジストリのエントリー：https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.forcedreamai/mcp-server
• MCP：https://modelcontextprotocol.io
• 実際にテスト済みの例：EXAMPLES.md

ライセンス

MIT