AI导哈

证券账户数据服务

一个非官方的MCP服务器，用于将Mirae Asset Securities账户数据暴露给AI助手，如Claude，通过无头浏览器认证并查询内部Web API获取投资组合和性能数据。

  • by Astro36
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Astro36/miraeasset-account-mcp-unofficial

使用说明

Miraeasset账户MCP（非官方）

⚠️ 这是一个非官方的、社区制造的MCP服务器。它不隶属于Mirae Asset Securities，也不由其背书或支持。使用风险由您自行承担。

一 MCP（模型上下文协议） 暴露您的服务器 未来资产证券 将账户数据发送给Claude等人工智能助手。它通过无头浏览器进行身份验证，并查询内部web API以检索您的投资组合持股和业绩数据。

运作原理

  1. 首次使用时，无头Chromium浏览器会使用您的凭据登录Mirae Asset门户网站。
  2. 会话cookie(MIREADW_D)被提取并缓存在内存中。
  3. 所有后续的数据请求都使用该cookie直接调用内部JSON API，没有浏览器开销。

可用工具

get_account_numbers

以格式化形式返回您的帐号列表（例如。 123-45-678901).

get_cash_equivalents

返回所有账户的现金和现金等价物资产，包括：

  • 外币 --货币代码、汇率、可提取市值
  • RP（回购协议）产品 --产品名称、到期日、入账价值、当前价值

示例响应项：

{
  "type": "foreign_currency",
  "account_number": "123-45-678901",
  "name": "USD",
  "currency": "USD",
  "exchange_rate": 1380.5,
  "market_value": 1500.0
}

get_equities

返回所有账户的股权持有量（股票和ETF）。

每个项目包括：

  • account_number --格式化帐号
  • name --资产名称
  • symbol --股票代码/isine
  • currency --面额货币
  • exchange_rate --韩元汇率
  • quantity --持有股份数量
  • market_value --资产货币的当前市场价值
  • entry_value --总采购成本（韩元）

get_gold_spots

返回黄金现货头寸资产。与相同的架构 get_equities.

get_all_assets

在一次调用中获取所有资产类型的便利工具。

退货：

{
  "cash_equivalents": [...],
  "equities": [...],
  "gold_spots": [...]
}

get_performance(start_date, end_date?)

返回a 单个聚合PnL记录 适用于整个日期范围——对于月度总结或年初至今的绩效非常有用。

  • start_date --需要， YYYY-MM-DD
  • end_date --可选，默认为今天

示例响应：

{
  "start_date": "2025-01-01",
  "end_date": "2025-03-29",
  "initial_value": 10000000,
  "closing_value": 11200000,
  "cash_inflow": 500000,
  "cash_outflow": 200000
}

字段使用 时间加权回报 方法论（持有期回报）。 cash_inflow 和 cash_outflow 计入存款/取款和已实现损益。

get_weekly_performance(start_date, end_date?)

返回PnL记录 每周细分 （周一至周日）。有助于绘制业绩趋势图或确定哪些周推动了回报。

  • start_date --需要， YYYY-MM-DD
  • end_date --可选，默认为今天

返回与具有相同架构的记录列表 get_performance.

设置

先决条件

  • Python 3.12+
  • 谷歌Chrome/Chromium+匹配 chromedriver 在你的 PATH
  • 未来资产证券网络登录账户

安装

git clone https://github.com/your-username/miraeasset-account-mcp-unofficial.git
cd miraeasset-account-mcp-unofficial
pip install -e .

配置

复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

MIRAE_USER_ID=your_login_id
MIRAE_USER_PASSWORD=your_password

您的凭据仅在本地用于获取会话cookie。除了Mirae Asset的官方登录页面，它们从未被发送到其他任何地方。

跑步

python server.py

服务器通过stdio（标准MCP传输）进行通信。

码头工人

包含一个Docker设置，它捆绑了Chromium和chromedriver——不需要本地安装Chrome。

使用Docker Compose（推荐）

# Make sure .env is configured
docker compose up --build

手动Docker

docker build -t miraeasset-mcp .
docker run --env-file .env -i miraeasset-mcp

连接到克劳德桌面

将以下内容添加到您的 claude_desktop_config.json:

没有Docker（本地Python）：

{
  "mcpServers": {
    "miraeasset": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"],
      "env": {
        "MIRAE_USER_ID": "your_login_id",
        "MIRAE_USER_PASSWORD": "your_password"
      }
    }
  }
}

使用Docker：

{
  "mcpServers": {
    "miraeasset": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "MIRAE_USER_ID=your_login_id",
        "-e", "MIRAE_USER_PASSWORD=your_password",
        "miraeasset-mcp"
      ]
    }
  }
}

示例提示

一旦连接到AI助手，你可以问这样的问题：

  • “我目前持有哪些股票？”
  • “显示我的投资组合总价值，包括外币。”
  • “今年到目前为止，我的投资组合表现如何？”
  • “给我一份2025年第一季度回报的每周明细。”
  • “我有什么RP产品，它们什么时候成熟？”

安全说明

  • 凭据从环境变量中读取，从不记录或持久化。
  • 会话令牌仅存储在内存中，并在进程退出时丢失。
  • 此服务器使用Mirae Asset的 内部web API --与他们的移动门户网站使用的相同。这些API没有公开记录，可能会在不通知的情况下更改。

免责声明

该项目不隶属于未来资产证券，也不受其认可。这里使用的内部API没有文档记录，随时可能更改，恕不另行通知。此工具按原样提供，不提供保修。作者不对因使用而产生的任何问题负责，包括但不限于帐户访问问题或数据不准确。

许可证

看 许可证.

相关 MCP