Olive Kit

面向财富场景的 Model Context Protocol（MCP） 工具包：在支持的 AI 客户端中查询**私募基金（产品）**货架、详情、业绩、持仓穿透与文档等（产品侧公开信息）。

本地开发、环境变量、客户侧工具开关与发布流程见仓库内 README-DEV.md（该文件不随 npm 包分发）。

安装

需要 Node.js 18+。

npm install -g @oliveam/olive-kit

安装后可使用命令：oliveam（配置与注册）、oliveam-mcp（MCP 服务进程，一般由客户端配置调用）。

快速开始

1. 初始化凭据

   oliveam config init

   按提示输入 API Key 与 Secret Key。配置文件默认位于 ~/.oliveam/config.toml；请求使用 HMAC 签名（详见下文「鉴权」）。

2. 将 MCP 注册到 Claude（二选一）

   oliveam-mcp setup --client claude-code
   oliveam-mcp setup --client claude-desktop

   • claude-code：通过 claude mcp add 注册。
   • claude-desktop：写入本机 Claude Desktop 的 MCP 配置；写入前会备份 .bak，修改后请重启 Claude Desktop。

3. 在对话中直接提问，例如：「查一下某只私募的近期业绩」「在售的基建类产品有哪些」。

通过环境变量直接注入凭据（可选）

如果你不想全局安装 @oliveam/olive-kit，也可以使用 npx -y 直接运行（客户端配置示例）：

{
  "mcpServers": {
    "oliveam-mcp": {
      "command": "npx",
      "args": ["-y", "-p", "@oliveam/olive-kit@latest", "oliveam-mcp"],
      "transport": "stdio",
      "env": {
        "OLIVEAM_API_KEY": "your-api-key",
        "OLIVEAM_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

当 OLIVEAM_API_KEY 与 OLIVEAM_SECRET_KEY 同时存在时，启动会跳过 ~/.oliveam/config.toml 的检查并直接使用环境变量；否则回退到配置文件。

提供的 MCP 工具（产品维度）

私募基金工具需先通过 search_funds 取得 detailKey 与 detailType。

私募基金

| 工具 | 说明 | |------|------| | search_funds | 关键词搜索基金，返回 detailKey、detailType；可选 showCard | | list_funds | 全货架分类与标签（Markdown） | | list_fund_cards | 按资产类别汇总所有在售基金卡片 | | get_fund_detail | 单只基金详情概览（策略、费率等） | | get_fund_summary | 单只基金概况摘要 | | get_fund_card | 单只基金卡片数据（收益、净值、标签等） | | get_fund_performance | 单只基金历史业绩 | | get_fund_portfolio | 单只基金底层资产配置与持仓明细 | | list_fund_materials | 基金材料列表（PDF 等）与分类 | | search_fund_docs | 基金文档语义搜索 |

结构化产品

| 工具 | 说明 | |------|------| | search_sp_underlying | 搜索 FCN 挂钩标的（港股/美股） | | create_sp_rfq | 发起 FCN 询价，返回 taskId | | get_sp_rfq_result | 按 taskId 查询单次询价结果 | | list_sp_batches | 获取结构化产品运营货架批次列表 | | get_sp_batch | 按 batchId 查询单个批次详情 |

配置管理

oliveam config show
oliveam config set api_key <新值>
oliveam config set secret_key <新值>
oliveam config init

鉴权

请求会携带（由本包根据配置自动生成）：

| Header | 说明 | |--------|------| | Authorization | Bearer token（基于 api_key 与时间戳的 HMAC） | | X-Api-Key | API Key | | X-Genesis-Client | 固定值 genesis-kit，供网关识别客户端 |

License

MIT — 见仓库中的 LICENSE。