Vc Finder

vc-finder

VC／エンジェル投資家のグラフです。資金調達に適した投資家、各ラウンドの参加者、企業のどの投資担当者にアプローチすべきかを確認できます。すべての事実に出典ページが付いています。まずMojibake自身の資金調達（Bruceの依頼：2026-09-29）向けに構築され、fleet #2663で公開されました（Bruce、2026-10-01：「まず公開してしまおう。そのほうがテストしやすい」）。npmでは公開されていません。これはBruceの承認が必要な別の手順です。docs/vc-graph-plan.md、docs/vc-graph-architecture.md、docs/vc-finder-staging-contract.mdを参照してください。

Pipeworxの一部です。AI エージェントを1688以上の稼働中のデータソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、推奨、公開のいずれもされていません。

ストア：PostgresではなくD1（fleet #2526のストア変更）

アーキテクチャドキュメント（§1）では当初、専用のSupabase Postgresプロジェクトを指定していました。**2026-09-30にPMによって変更されました（Bruceが新たなSupabaseへの支出を却下）：ストアは1つのCloudflare D1データベースです。**スキーマはsql/vc-finder-schema.sqlite.sqlです。並行作業で構築した際に、Lieselの完全な移植版がまだorigin/mainに存在しなかったため、このパックの8つのツールが必要とするテーブルだけを対象に移植しました。彼女のものが追加されたら、2つのスキーマファイルが分岐しないよう、こちらを削除して統合してください。

構成

• mcps/vc-finder/ — このパックです。vc_をプレフィックスとする10個のツールを提供します。_vcIndexというサービスバインディング形式のオブジェクトを呼び出します（fetchではなくRPCメソッドです。src/index.tsのVcIndexBindingを参照）。POD_INDEXの先行例（workers/pod-index、docs/pod-researcher-design.md）と同じ構成です。
• workers/vc-index/ — pipeworx-vc-indexワーカーのひな形です。D1バインディングに対するパラメーター化SQLを使うsrc/queries.tsをバックエンドとして、ツールごとに1つのRPCメソッドを公開するWorkerEntrypointです（ストアドプロシージャは使用しません。D1にはありません）。**デプロイ済み（fleet #2579）**で、pipeworx-vc-finder D1データベースに接続されています。CIはプッシュ時にコードを再デプロイします（.github/workflows/deploy-vc-index.yml）。データには一切触れません。
• scripts/vc-finder/fixtures/seed.sqlite.sql — ローカルテスト専用の固定IDフィクスチャです（a16z、Sequoia、SignalFire、2社、2つのラウンド、出典情報付きの主張、事前計算済みのinvestor_sector_portfolio_counts／investor_observed_statsの行）。

ローカルテスト（リモートD1データベースは使用しないでください）

wrangler d1 execute VC_INDEX_DB --local --cwd workers/vc-index \
  --file sql/vc-finder-schema.sqlite.sql -y
wrangler d1 execute VC_INDEX_DB --local --cwd workers/vc-index \
  --file scripts/vc-finder/fixtures/seed.sqlite.sql -y

その後、直接クエリを実行する（wrangler d1 execute VC_INDEX_DB --local --cwd workers/vc-index --command "..."）か、ハーネスで_vcIndexをsrc/queries.tsの関数にモックして、生成されたローカルD1のSQLiteファイル（workers/vc-index/.wrangler/state/v3/d1/...）に対してパックのcallTool()を実行してください。受け入れ確認の証跡を作成した際に使用した正確なハーネスについては、fleet #2526のタスク記録を参照してください（tscでコンパイルし、Nodeのnode:sqliteで実行しました）。

担当者と連絡経路（fleet #2561）

Bruce による 2026-09-30 付けの事例判断：投資担当者には、本人たちが公開した連絡経路を案内します。担当者向けのツールは vc_search_people と vc_get_person の 2 つです。vc_get_investor は、各社のパートナーとその連絡経路を一覧表示し、既知の場合、vc_find_investors_for_company は各社の relevant_partner を示します（最も上級の投資担当者を優先し、次に連絡経路を公開している担当者を優先します）。すべての経路で exposure_hold = 0 の担当者のみを扱い、読み取り時に削除リスト（scripts/vc-finder/removal-list.json を反映した removal_entry）を確認します。テスト：workers/vc-index/src/queries.people.test.mts。読み込みと ER の詳細：「ストアが担当者を読み込み、提供する方法」(docs/vc-finder-staging-contract.md)。

呼び出し元が確認できる場所で情報源と削除方法を明示します（パックが公開されたため必須 — CLAUDE.md の「個人データ」、Bruce による事例判断）。 担当者とその連絡経路は、公開情報のみを使用します。情報源は、企業の公式サイトまたは本人が公開しているページです。すべての連絡経路には、公開元のページ、そのことを示す引用文、個人用または役職用のラベルを付けます。電話番号と自宅住所は収集しません。 誰でも [email protected] に削除を依頼できます。依頼があれば scripts/vc-finder/removal-list.json に追加し、読み取り時の処理ですぐに除外します。次の読み込みを待つ必要はありません。vc_search_people と vc_get_person の説明にも同じ内容が記載されているため、このファイルを読まない呼び出し元にも伝わります。また、どちらかの説明からこの内容が失われると tests/scope-is-not-a-gate.test.ts が失敗します。

fleet #2663 以降の公開状態 — 非公開のゲートの内容と、その置き換え

fleet #2579 までは、このパックはマニフェストで unlisted に設定され、PRIVATE_PACKS に登録され、BOARD_OWNER_CALLERS と内部トラフィック以外には not found として非表示になり（workers/gateway/src/index.ts の NOT_FOUND_PRIVATE_SLUGS）、さらにパック内でも assertAllowed() によって同じルールが再確認されていました。この 4 つはすべてなくなりました。 どの呼び出し元もすべてのツールを呼び出せます。

NOT_FOUND_PRIVATE_SLUGS は削除されず、空のセットとして残っています。次の非公開パック用のゲートであり、メンバーがいない場合、privatePackVisible() はすべての slug に対して true を返すため、このセットを対象にテストが成功しても not-found 経路の動作は証明できません。このことは、セットの定義で明記されています。

したがって、グラフ内の担当者を保護するのは、もはやゲートではありません。保護するのは、以下の読み取り時の削除確認です。これが、以前から実際の制御手段でした。

デプロイ済みデータの更新

D1 データベースには、完全なローカルビルドではなく、提供用のコピーのみが格納されます。

node scripts/vc-finder/build-deploy-copy.mjs "$VC_DATA/<build>.sqlite" "$VC_DATA/vc_finder_deploy.sqlite"
node scripts/vc-finder/d1-export-chunks.mjs "$VC_DATA/vc_finder_deploy.sqlite" "$VC_DATA/d1-import"
node scripts/vc-finder/d1-import.mjs "$VC_DATA/d1-import"      # resumable; verifies row counts

build-deploy-copy.mjs は、保留対象の担当者（exposure_hold = 1）、その担当者のみを理由に存在するすべての行、担当者フラグが付いた企業、参照先のない統合済み企業を除外し、保留対象の担当者または孤立した項目が残っている場合は処理を完了しません。インポート先には新しいデータベースを使用します（スキーマファイルは通常の CREATE 文です）。更新するには、新しいデータベースを作成してインポートし、その後 database_id を切り替えます。

既知の不足（v0 の骨組み。このタスクでは未修正）

• vc_find_investors_for_company は呼び出しごとに VC に該当するすべての組織を引き続きスコアリングしますが、固定回数のセットクエリで実行します（fleet #2579 — 以前は候補ごとに D1 クエリを 3 回実行しており、実際のストアでは D1 の呼び出しあたりの上限である 1,000 クエリを超えていました）。重要な適合候補をマテリアライズしたテーブルがあれば、読み取る行数を減らせます。
• 金額フィールドは REAL です。これらのフィクスチャに含まれるドル単位の整数額には問題ありませんが、実際の金額にセント単位が含まれるようになったら再検討する価値があります（整数のセント単位にするなど）。
• ここにはローダーや挿入経路はありません。タスクの対象は読み取り側のみです。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "vc-finder": {
      "url": "https://gateway.pipeworx.io/vc-finder/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/vc-finder/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック専用のツールとともに、共通ツールが約 30 個表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の状況についてはこれが正式な回答です。

これは意図的な仕様であり、意図せず多重化されているわけではありません。メタツールを使うと、このパックが対応していない質問にも、カタログ全体を対象に振り分ける ask_pipeworx を通じて回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントに接続する方法はありません。追加のスキーマが、ルーティングによる利点よりも多くのコンテキストを消費する場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1688 以上のデータソースに接続します。違いは、どのパックのツールが直接表示されるかだけです。どちらからでも、ask_pipeworx を通じてすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/vc_search_investors \
  -H 'Content-Type: application/json' \
  -d '{"stage":"seed","geo":"US","limit":5}'

最初の呼び出しにはアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/vc_search_investors を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も必要ありません。

{
  "mcpServers": {
    "vc-finder": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-vc-finder"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-vc-finder

stdin／stdout 経由で MCP を通信し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは、上記のパックのエンドポイントとフルゲートウェイのどちらでも使えます。

ask_pipeworx({ question: "your question about Vc Finder data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

その他

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT