Vantage

Vantage

追踪你看到的内容。留待日后使用。

Vantage 是一款面向 AI 原生工作流程的个人信号库——用于记录和查询你在网上留意到的内容。

X 上的一条帖子。LinkedIn 上的一个讨论串。一篇文章中的见解。竞争对手的动向。 与其让这些内容散落在标签页、截图和笔记中，不如保存起来，留待日后使用。

---

为你的所有 AI 工具提供统一的记忆层

你的 AI 工具之间不会共享记忆。

• Claude 不知道你在 X 上看到了什么
• ChatGPT 不知道你昨天读了什么
• 你的代码工具不了解你的研究内容

Vantage 可以解决这个问题。

只需保存一次信号，就能在任何支持 MCP 的客户端中访问——包括 Claude、Cursor 和其他受支持的工具。

---

工作原理

1. 将 Vantage 连接到你的 AI（通过 MCP）
2. 直接从工作流中保存信号
3. 围绕已保存的内容提问

示例：

“将此保存为信号”

“我保存过哪些关于定价的内容？”

“显示 Lemkin 的信号”

---

Vantage 是什么（又不是什么）

• 不是爬虫——由你选择哪些内容重要
• 不是信息流——没有噪声或算法带来的杂乱内容
• 不是知识库——无需维护系统

Vantage 让你轻松追踪所看到的内容，这样你的 AI 就能在日后真正用上它们。

---

托管版 + 开源

• 免费托管版：vantage.cavendo.ai
• 可自托管：采用 MIT 许可证，可在任意位置运行

---

快速开始

选项 1：使用托管版（最快）

在 vantage.cavendo.ai 注册。连接到 Claude 或其他受支持的客户端。开始捕捉内容。

大约需要 2 分钟。无需安装。

选项 2：在本地运行

npm install
npm run dev

# If 3020 is already in use, choose another port
PORT=YOUR_PORT npm run dev

# Generate your first API key
curl -X POST http://localhost:3020/api/auth/keys \
  -H 'Content-Type: application/json' \
  -d '{"name": "my-key"}'

无需身份验证，即可从 localhost 创建第一个 API 密钥。如果你要从零开始部署到远程环境，请在服务端设置 VANTAGE_BOOTSTRAP_TOKEN，并在首次请求的 X-Vantage-Bootstrap-Token 标头中发送相同的值。 API 密钥会以 data.key 的形式在 JSON 响应中返回。

捕捉你的第一个信号：

curl -X POST http://localhost:3020/api/signals \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer vtg_YOUR_KEY_HERE' \
  -d '{
    "signalType": "post",
    "platform": "x",
    "content": "Every SaaS company will need an agent layer within 18 months.",
    "topics": ["AI Agents", "SaaS"],
    "importance": "high"
  }'

---

MCP 服务

Vantage 内置了 MCP 服务，提供 13 个工具，可与 Claude、Claude Code、Cursor 或任何兼容 MCP 的客户端配合使用。

如果你想直接使用捆绑的 stdio MCP 服务，也需要安装其依赖项：

cd mcp-server
npm install
cd ..

Claude Code

claude mcp add vantage --transport http "http://localhost:3020/mcp" --header "Authorization: Bearer vtg_YOUR_KEY"

手动测试时，请注意 /mcp 是一个可流式传输的 HTTP 端点。MCP 客户端会自动处理响应格式，但临时使用 curl 调用时，需要准备好处理面向流的响应，而不是简单的纯 JSON 请求/响应流程。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "vantage": {
      "command": "node",
      "args": ["/path/to/vantage/mcp-server/src/index.js"],
      "env": {
        "VANTAGE_API_URL": "http://localhost:3020",
        "VANTAGE_API_KEY": "vtg_YOUR_KEY_HERE"
      }
    }
  }
}

MCP 工具

工具	功能
capture_signal	保存帖子、文章、引言或讨论。自动创建来源和主题。
search_signals	带筛选条件的全文搜索——平台、主题、日期范围、重要性。
list_recent_signals	获取最新信号流。
get_signal	查看特定信号的完整详情。
manage_source	创建或更新你正在追踪的人物／账号。
list_sources	查看所有正在追踪的人物／账号及其信号数量。
manage_topic	创建或更新主题／专题。
list_topics	查看所有主题及其信号数量。
manage_collection	将信号归入命名集合。
set_business_context	上传策略文档以供比较。
analyze_signals	汇总信号和背景信息以供分析。
get_dashboard	查看摘要——数量、热门主题、热门来源和重点内容。
save_analysis	保存分析结果以供日后参考。

---

集成

• OpenClaw 社区技能：vantage-shared-intel——通过 OpenClaw，基于同一 Vantage 数据集捕捉信号、搜索已有情报并生成共享摘要。

---

REST API

大多数 API 请求都需要 Authorization: Bearer vtg_YOUR_KEY。

例外：

• GET /health
• POST /api/auth/keys，用于从 localhost 首次创建密钥，或由提供有效 X-Vantage-Bootstrap-Token 的远程客户端首次创建密钥

Method	Endpoint	Description
POST	/api/signals	创建信号
GET	/api/signals	根据筛选条件列出信号
GET	/api/signals/search?q=query	全文搜索
GET	/api/signals/feed	按时间顺序排列的信息流
GET	/api/signals/:id	信号详情
POST	/api/sources	创建来源
GET	/api/sources	列出来源
POST	/api/topics	创建主题
GET	/api/topics	列出主题
POST	/api/collections	创建集合
POST	/api/contexts	上传业务背景信息
GET	/api/dashboard/summary	仪表板摘要
POST	/api/auth/keys	生成 API 密钥

---

技术栈

Component	Technology
运行时	Node.js 20+ / Express / ESM
数据库	通过 better-sqlite3 使用 SQLite
验证	Zod
身份验证	API 密钥（vtg_ 前缀），经 SHA-256 哈希处理
MCP	@modelcontextprotocol/sdk（stdio + HTTP）

---

环境变量

Variable	Default	Description
PORT	3020	服务端口
NODE_ENV	development	环境
DATABASE_PATH	./data/vantage.db	SQLite 文件路径
CORS_ORIGIN	*	CORS 允许的来源
VANTAGE_BOOTSTRAP_TOKEN	未设置	当非 localhost 客户端发送 X-Vantage-Bootstrap-Token 时，允许其首次创建 API 密钥

---

许可证

MIT — 随你使用。

---

由 Jonathan Arehart 在 Cavendo AI 构建。