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 Agent 连接到 1688+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未获其认可，也未由其发布。

存储：D1，而非 Postgres（fleet #2526 存储变更）

架构文档（§1）最初要求使用专用的 Supabase Postgres 项目。**2026-09-30 起，因 PM（Bruce 排除了新增 Supabase 开支）作出的决定，该方案已被取代：存储使用一个 Cloudflare D1 数据库。**Schema： sql/vc-finder-schema.sqlite.sql——这是一个精简移植版（仅包含该工具包的 8 个工具所需的表），编写时 Liesel 的完整移植版尚未合并到 origin/main，因此并行编写了此版本。她的版本合并后，务必将两者统一；删除此文件，避免两份 schema 文件逐渐产生差异。

结构

• mcps/vc-finder/ — 此工具包。包含 10 个工具，前缀为 vc_。调用一个形似服务绑定的 _vcIndex 对象（RPC 方法，而非 fetch — 参见 src/index.ts 中的 VcIndexBinding），其结构与 POD_INDEX 先例相同（workers/pod-index、docs/pod-researcher-design.md）。
• workers/vc-index/ — pipeworx-vc-index worker 骨架。一个 WorkerEntrypoint，为每个工具公开一个 RPC 方法，由 src/queries.ts 提供支持（针对 D1 绑定执行参数化 SQL——没有存储过程；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、两家公司、两轮融资、带有溯源信息的声明，以及预计算的 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 的测试程序，将工具包的 callTool() 调用于生成的本地 D1 sqlite 文件（workers/vc-index/.wrangler/state/v3/d1/...）。该模拟程序使用 src/queries.ts 中的函数——具体测试程序参见 fleet #2526 的任务记录，其中包含用于生成验收证据的确切测试程序（使用 tsc 编译，通过 Node 的 node:sqlite 运行）。

人员与联系途径（fleet #2561）

Bruce 在 2026-09-30 的案例裁定：投资人员通过其公开发布的联系途径接受联系。vc_search_people 和 vc_get_person 是两个人员工具；vc_get_investor 会列出某家公司的合伙人及其联系途径；如果已知，vc_find_investors_for_company 会为每家公司指出一位 relevant_partner（优先选择最高级别的投资职位，其次选择公开发布了联系途径的人）。所有路径只提供 exposure_hold = 0 的人员，并在读取时检查移除名单（removal_entry，从 scripts/vc-finder/removal-list.json 镜像而来）。测试：workers/vc-index/src/queries.people.test.mts。加载与 ER 详情：docs/vc-finder-staging-contract.md 中的 “How the store loads and serves them”。

在调用方可见之处说明来源与移除方式（现在该工具包已公开，因此为必需项——CLAUDE.md “Personal data”，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 以外的所有人及内部流量隐藏，并显示为未找到（workers/gateway/src/index.ts 中的 NOT_FOUND_PRIVATE_SLUGS）；此外，工具包内部还会通过 assertAllowed() 再次检查同一规则。以上四项均已移除。 任何调用方都可以调用所有工具。

NOT_FOUND_PRIVATE_SLUGS 现在是一个空集合，而非已删除——它是下一个私有工具包的访问门；由于集合中没有成员，privatePackVisible() 对所有 slug 都会返回 true，因此通过它的绿色测试无法证明未找到路径有效。集合定义处已明确说明这一点。

因此，图中人员的保护措施不再是访问门，而是下面的读取时移除检查；它始终才是真正的控制措施。

刷新已部署数据

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 查询，在真实数据存储上会超过 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 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由功能带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 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