使用说明
金融MCP服务器
MCP（模型上下文协议）服务器，为LLM提供对您的 财务 投资组合。内置于 FastMCP 以及非官方 财务_ API 客户。
服务器将Finary冗长的API响应（通常为90%+噪音）剥离为干净、报告友好的JSON，只保留重要的字段进行分析。
工具
目前，此MCP服务器仅提供读取功能
| 工具 | 说明 |
|---|---|
signin |
通过MFA向Finary进行身份验证。LLM会要求您提供6位TOTP代码。 |
investments |
投资账户及其证券（名称、ISIN、数量、价值、损益）。 |
cryptos |
加密货币持有量（名称、代码、数量、价格、损益）。 |
real_estates |
有贷款和租金信息的房地产。 |
scpis |
SCPI（房地产基金）控股。 |
fonds_euro |
持有年收益率欧元基金。 |
先决条件
- 码头工人
- A. 财务 启用MFA（TOTP）的帐户
设置
1.构建Docker镜像
cd finary-mcp
docker build -t finary-mcp .
Dockerfile克隆 finary_uapi 在构建时从GitHub下载——不需要该库的本地副本。
2.配置克劳德桌面
编辑您的Claude Desktop配置文件：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
添加（或合并） finary 条目：
{
"mcpServers": {
"finary": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "FINARY_EMAIL",
"-e", "FINARY_PASSWORD",
"finary-mcp"
],
"env": {
"FINARY_EMAIL": "your-email@example.com",
"FINARY_PASSWORD": "your-password-here"
}
}
}
}
替换中的占位符值 env 使用您的实际财务凭证。
3.重新启动克劳德桌面
完全退出并重新打开Claude Desktop，以便它能够启动新的MCP服务器。
身份验证的工作原理
证书(FINARY_EMAIL, FINARY_PASSWORD)作为环境变量注入Docker容器。它们从不存储在磁盘上。
首次使用时，LLM调用 signin 触发最终登录流的工具。由于您的帐户已启用MFA，LLM将要求您从身份验证器应用程序中获取6位TOTP代码。登录后，会话将在会话期间缓存在容器中。
每个容器运行都是全新开始的——会话之间没有令牌或Cookie。
不使用Docker运行
你也可以直接用Python 3.10+运行服务器：
pip install fastmcp docopt fuzzywuzzy "curl-cffi>=0.13,<0.15"
git clone https://github.com/lasconic/finary_uapi.git /tmp/finary_uapi
export PYTHONPATH="/tmp/finary_uapi:$PYTHONPATH"
export FINARY_EMAIL="your-email@example.com"
export FINARY_PASSWORD="your-password-here"
python mcp_server.py
项目结构
finary-mcp/
├── Dockerfile # Self-contained build (clones finary_uapi from GitHub)
├── mcp_server.py # MCP server: 6 tools + response simplification
├── claude_desktop_config.json # Example Claude Desktop configuration
└── README.md
