AI导哈

投资组合追踪服务

一款用于追踪多人多账户投资组合的模型上下文协议（MCP）服务器，支持英国投资者的累积基金细节如收入保留和累积均衡。

  • by rjeans
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 rjeans/portfolio-mcp

使用说明

投资组合mcp

用于跟踪多人、多账户投资组合的模型上下文协议（MCP）服务器。专为英国投资者打造，支持积累基金的细微差别，如收入保留和积累均衡。

特征

  • 多人、多账户 --跟踪不同人员（如家庭）和账户类型（ISA、SIPP、投资）的投资组合
  • 先进先出成本会计 --基于批次的跟踪，采用先进先出的处理方式，以获得准确的成本基础和损益
  • 收入保留和累积均衡 --正确调整英国公积金的成本基础，与经纪人的税收成本计算相匹配
  • 雅虎财经整合 --实时定价，自动将英镑（便士）转换为英镑
  • 手动价格超控 --为雅虎财经上不可用的资金设定价格
  • 历史价格导入 --从外部来源（如英国《金融时报》）导入雅虎缺失资金的历史价格
  • 投资组合历史 --具有可配置间隔（每日/每周/每月）的价值、成本基础和损益的时间序列
  • JSON文件存储 --具有原子写入的简单、可移植的数据格式

MCP工具

工具 说明
add_person 将一个人添加到投资组合中
list_persons 列出所有人员
add_account 添加投资账户（ISA、SIPP、投资）
list_accounts 列出帐户，可选择按人员筛选
add_transaction 记录购买、出售、保留或均衡
remove_transaction 按ID删除交易
list_transactions 列出交易，可选择按账户或股票代码过滤
get_portfolio_summary 获取当前头寸、成本基础和损益
get_account_positions 获取特定账户的职位
get_asset_allocation 按持有、人员和账户类型获取分配明细
refresh_prices 从雅虎财经刷新实时价格
set_price 手动设置股票的当前价格
set_manual_pricing 将股票代码标记为手动定价，以便在自动刷新期间跳过（可选地存储查找URL）
import_historical_prices 导入历史价格以用于投资组合历史
get_price_history 获取股票代码的存储价格历史记录（导入+缓存）
get_portfolio_history 获取历史投资组合估值作为时间序列

设置

npm install
npm run build

克劳德代码/克劳德桌面

添加到MCP配置中：

{
  "mcpServers": {
    "portfolio": {
      "command": "node",
      "args": ["/path/to/portfolio-mcp/dist/index.js"]
    }
  }
}

事务类型

类型 描述
buy 购买股份/单位
sell 出售股份/单位（先进先出成本处置）
retention 收入保留——增加成本基础（由英国acc基金每年报告）
equalisation 累积均衡——降低成本基础（购买后首次分配的资本回报）

数据存储

投资组合数据存储在 ~/.config/portfolio-mcp/portfolio.json （macOS和Linux上的路径相同）。目录和文件在首次使用时会自动创建。

集 PORTFOLIO_DATA_DIR 覆盖——对于开发或针对测试数据集运行非常有用：

PORTFOLIO_DATA_DIR=./data npm run start

雅虎财经的价格会被缓存24小时。手动价格一直持续到被覆盖为止。

英国基金定价

雅虎财经以英镑（便士）而不是英镑（英镑）返回一些英国基金价格。服务器会自动检测并转换这些数据。对于雅虎财经上没有的资金，请使用 set_price 以当前价格或 import_historical_prices 历史数据。

许可证

国际学生委员会

相关 MCP