关于 Kova
Kova 是为投资 Agent 提供持久策略与组合核对流程的服务插件。策略保存、记录资产负债及生成简报前都需明确批准;它不执行交易、预测市场或挑选证券。
主要功能
- 01创建或完善投资策略
- 02批准后保存策略
- 03按策略检查投资组合
- 04批准后生成策略简报
- 05通过 OAuth 连接托管服务
适用场景
- 01将投资目标和约束整理为策略
- 02核对投资组合是否符合既定策略
- 03审阅组合简报中的一致性与冲突
MCP 相关
插件为支持 Agent Plugins v1 的客户端提供连接 Kova 托管 MCP 服务的工作流,使用 OAuth 认证。Agent 可调用共享策略检查组合;策略保存及组合检查简报生成均需明确批准。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://kovatools.com/mcpclaude mcp add --transport http com-kovatools-kova https://kovatools.com/mcp{"mcpServers":{"com-kovatools-kova":{"type":"http","url":"https://kovatools.com/mcp"}}}在 Cursor 中打开{"servers":{"com-kovatools-kova":{"type":"http","url":"https://kovatools.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-kovatools-kova":{"type":"http","url":"https://kovatools.com/mcp"}}}{"mcpServers":{"com-kovatools-kova":{"serverUrl":"https://kovatools.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
让每个 Agent 都拥有相同的投资策略。
Kova 是面向 Agent 投资者的策略层。它为兼容的 AI Agent 提供持久的投资策略、一种共同的方式来检查投资组合是否符合策略,并在 Kova 保存策略或创建简报之前设定明确的审批边界。
从策略到简报
策略 → 审批 → 投资组合 → 简报
- 将你的目标、限制条件和投资原则转化为持久的策略。
- 查看确切的策略,并在 Kova 保存任何内容之前予以批准。
- 连接投资组合,然后让 Agent 根据同一策略进行检查。
- 批准投资组合检查,并获得一份包含契合度、冲突点和后续问题的策略简报。
插件提供的功能
- 创建或完善策略。 通过对话制定个人投资策略,并在保存前查看完整预览。
- 检查投资组合契合度。 将策略作为稳定的参考依据,用于投资组合审查和策略简报。
该插件封装了 Kova 的策略工作流和安全的 MCP 连接,适用于支持 Agent Plugins v1 的客户端。它连接到 Kova 的托管服务,因此无需构建本地服务,也无需将 API 密钥写入文件。
信任与审批边界
Kova 在保存策略、记录投资组合资产或负债,或创建简报之前,都会要求明确审批。它不会执行交易、预测市场走势,也不会替你选择证券。
身份验证通过 Kova 的 OAuth 流程完成。插件不包含任何凭据、授权标头、令牌或特定于客户端的 OAuth 配置。策略文本、持仓和账户数据均不会包含在插件包中。
ChatGPT 中发布的 Kova 应用是单独的分发渠道。安装该应用不会安装此 Agent 插件,安装此 Agent 插件也不会添加 ChatGPT 应用。
安装
包含 plugin.json 的目录就是插件根目录。请安装仓库根目录,而不是其 skills/ 目录。
Claude Code
claude plugin marketplace add kovatools/kova-agent-plugin
claude plugin install kova@kova
运行一次 /mcp 以登录 Kova。若要免安装试用,请使用 claude --plugin-dir /absolute/path/to/kova-agent-plugin 启动会话。
Gemini CLI
gemini extensions install https://github.com/kovatools/kova-agent-plugin
该扩展会连接到 https://kovatools.com/mcp,并在首次使用时通过 Kova 的 OAuth 流程登录。
VS Code:直接从 Git 安装
VS Code 可以通过仓库 URL 克隆并安装插件:
- 确认已通过
chat.plugins.enabled设置启用 Agent Plugins。 - 打开命令面板并运行 Chat: Install Plugin From Source。
- 输入
https://github.com/kovatools/kova-agent-plugin。 - 查看源信任提示,安装插件,然后开始新的聊天。
若要更新,请运行 Extensions: Check for Extension Updates。启用扩展自动更新后,VS Code 也会自动检查更新。若要卸载,请在 Agent Plugins - Installed 下找到 Kova,打开其上下文菜单,然后选择 Uninstall。
若要改用本地克隆,请在 VS Code 设置中注册插件根目录:
{
"chat.pluginLocations": {
"/absolute/path/to/kova-agent-plugin": true
}
}
有关当前界面和设置,请参阅 VS Code 中的 Agent 插件。
Cursor:在本地克隆或创建符号链接
Cursor 会从 ~/.cursor/plugins/local 加载本地插件:
mkdir -p ~/.cursor/plugins/local
git clone https://github.com/kovatools/kova-agent-plugin.git ~/.cursor/plugins/local/kova
重启 Cursor,或运行 Developer: Reload Window。开发时,你可以在其他位置克隆仓库,再将仓库根目录创建为符号链接:
ln -s /absolute/path/to/kova-agent-plugin ~/.cursor/plugins/local/kova
要更新克隆副本,请运行 git -C ~/.cursor/plugins/local/kova pull --ff-only,然后重新加载 Cursor。要卸载,请仅从 ~/.cursor/plugins/local 中移除 kova 克隆副本或符号链接,然后重新加载 Cursor。有关当前的本地插件流程,请参阅 Cursor 插件。
其他兼容客户端
克隆一个发行版本,然后将仓库根目录复制或创建为符号链接,放入客户端扫描插件的目录:
git clone --branch v0.1.1 --depth 1 https://github.com/kovatools/kova-agent-plugin.git
如果无法使用 Git,请从 GitHub 下载 v0.1.1 源代码压缩包,解压后,将解压出的仓库根目录注册为本地插件目录。
注册、更新和卸载行为由客户端决定,因为 Agent Plugins v1 定义的是软件包格式,而非通用安装程序。请参阅兼容客户端列表和客户端文档。要更新跟踪 main 的克隆副本,请使用 git pull --ff-only;对于不可变发行版本,请将克隆副本替换为较新的 SemVer 标签。要卸载,请取消注册插件根目录,并仅移除该本地克隆副本或符号链接。
身份验证
客户端首次连接到 https://kovatools.com/mcp 时,应打开 Kova 的 OAuth 授权流程:
- 在浏览器窗口中登录你的 Kova 账户。
- 查看客户端名称和请求的访问权限。
- 选择 Allow access。
- 返回客户端;如果请求未自动刷新,请重试。
Kova 使用带 PKCE 的 OAuth。本地客户端可以使用精确匹配的 http://localhost、http://127.0.0.1 或 http://[::1] 回调。Cursor 也可能使用其精确匹配的原生回调 cursor://anysphere.cursor-mcp/oauth/callback;其他所有回调都必须使用 HTTPS。访问 MCP 需要有效的 Kova 订阅。
要撤销连接,请从你的账户中移除对应的 Kova API 令牌。卸载插件不会撤销已签发的令牌。
发行版本与支持
请使用不可变的 GitHub Releases,以便重复安装并查看特定版本的兼容性说明。要报告安装问题、客户端兼容性问题或工作流错误,请提交问题。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。