aipulse

aipulse

aipulse は、AI 製品の状況を追跡する FalcoScan のホスト型 MCP サーバーへの、小規模なローカルブリッジです。各市場にどの製品が存在するか、市場の 機会度、飽和度、ラッパーリスクがどのように評価されているか、どの 製品が閉鎖または買収されたかを追跡します。

このブリッジは市場データを保持せず、独自のスコアも算出しません。 ライブエンドポイントから取得したままの上流サーバーのツール一覧を ローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。取得したインターフェースは全面的に読み取り専用です。 この再構築によって書き込み機能が追加されることはありません。

ツール

• lookup_product — 名前 （name）、ウェブサイト（url）、またはその両方で AI 製品を検索します。市場、事業継続中／閉鎖／買収済みの 状態（買収者、年、情報源）、機会度、飽和度、ラッパーリスクの各バンド、料金タイプ、無料 プラン、API の提供状況、創業年、本社、ウェブサイト、FalcoScan へのリンクを含む、最大 5 件の 一致結果を返します。すべての引数は省略可能です。
• ai_graveyard — FalcoScan が閉鎖または買収を確認した製品を返します。各製品には 公開された情報源が付いています。省略可能なフィルター：year、buyer、market。1 回の呼び出しにつき最大 25 件を 新しい順に返します。
• list_markets — FalcoScan がスコアを付けるすべての AI 市場と、その公開平均値（機会度、飽和度、 ラッパー比率、注目度）、事業継続中の製品数、市場ページへのリンクを返します。引数はありません。
• market_overview — 1 つの市場の詳細情報を返します。事業継続中の製品数、公開平均値、 閉鎖または買収された製品数、バンド付きの事業継続中製品の上位 10 件が含まれます。 必須：market（市場名またはスラッグ）。

設定

• FALCOSCAN_MCP_URL（省略可能）— 上流エンドポイントを上書きします。デフォルトは https://falcoscan.com/api/mcp です。（この上書き用フックは、 この再構築独自のものであることが明示されています。）
• FALCOSCAN_API_KEY（省略可能）— 設定すると、すべての上流リクエストに Authorization: Bearer <key> ヘッダーが付与されます。設定されていない場合は、 認証ヘッダーは送信されません。（この転送も再構築独自のものであることが明示されています。元のインターフェースはキーなしで 取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開始します。JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo の name aipulse）、続いて notifications/initialized 通知、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、 その値は以降のセッション内の各リクエストに付与され、プロセスの終了までセッションが再利用されます。応答は 通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取られます。

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま 返されます。JSON-RPC エラー、2xx 以外のステータス、読み取れない応答、 または完了できないリクエストなどの失敗は、テキストが aipulse error: で始まる isError 結果として返されます（この形式は この再構築独自のものであることが明示されています）。

CLI

各ツールは、1 つの JSON 引数文字列を取るサブコマンドとしても使用できます （引数を取らないツールでは省略します）。

npx @reneturcios/aipulse lookup_product '{"name":"Cursor"}'
npx @reneturcios/aipulse ai_graveyard '{"year":2025}'
npx @reneturcios/aipulse market_overview '{"market":"Healthcare"}'
npx @reneturcios/aipulse list_markets
npx @reneturcios/aipulse --version

終了コード：成功時は 0、isError 結果の場合は 1、 使用方法のエラーの場合は 2 です。

MCP サーバー

npx -y @reneturcios/aipulse mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "aipulse": {
      "command": "npx",
      "args": ["-y", "@reneturcios/aipulse", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/aipulse
docker run --rm ghcr.io/cloudcorprecords/aipulse --version

コンテナーのデフォルトコマンドは mcp であるため、最初の形式は stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC 上流サーバーに対して実行されます。ライブネットワークへの呼び出しはありません。

ライセンス

MIT — 詳細は LICENSE を参照してください。