Finam MCP Server

⚠️免责声明：这是一个用于演示和教育目的的非官方MCP服务器，适用于Finam Trade API。更多详情请参阅哈伯文章。

MCP（模型上下文协议）服务器用于通过Trade API与Finam交易平台进行集成。

功能

该服务器提供了对以下Finam Trade API功能的访问：

• 账户 - 获取账户信息、交易记录和成交记录
• 资产 - 处理交易工具、交易所、期权等
• 市场数据 - 获取市场数据（如K线图、报价、订单簿）
• 订单 - 创建、取消和监控交易订单

技术栈

• Python 3.12.6
• FastMCP - 用于创建MCP服务器的框架
• FinamTradeApiPy - Finam Trade API的Python封装

相关链接

• Finam Trade API 文档
• Finam API 的 Postman 集合

快速开始

安装依赖

# 使用uv安装（推荐）
uv sync

# 或者使用pip
pip install -e .

启动服务器

# 使用uvicorn简单启动
uvicorn src.main:finam_mcp --port 3000

使用MCP Inspector测试

MCP Inspector允许交互式地测试所有服务器工具：

npx @modelcontextprotocol/inspector

连接到服务器，使用地址："http://localhost:3000/mcp"

认证

服务器使用HTTP头进行认证：

• finam-api-key - 来自Finam个人账户的API密钥
• finam-account-id - 您的交易账户ID

您可以在Finam Trade的个人账户中获取API密钥和交易账户ID。

项目结构

src/
├── main.py              # 主MCP服务器
├── middleware.py        # 认证中间件
├── config.py            # 配置文件
├── servers/             # 专用MCP服务器
│   ├── account.py       # 账户操作
│   ├── assets.py        # 工具处理
│   ├── market_data.py   # 市场数据
│   └── order.py         # 交易操作
└── tradeapi/            # Finam Trade API的封装
    ├── finam.py         # 主客户端
    └── order/           # 订单模型和客户端

重要特性

交易工具符号格式

所有交易工具都以TIKER@MIC格式指定：

• SBER@MOEX - 在莫斯科交易所的Sberbank
• GAZP@MOEX - 在莫斯科交易所的Gazprom
• 默认使用的交易所是：MOEX，SPBE

时间格式

API要求日期和时间采用ISO 8601格式：

• 2024-01-15T10:30:00Z
• 2024-01-15T10:30:00+03:00

K线图的时间框架

可选的时间框架来自finam_trade_api.instruments.TimeFrame：

• M1, M5, M15, M30 - 分钟
• H1, H4 - 小时
• D1 - 日
• W1 - 周

支持

对于问题和建议，请在仓库中创建Issue。