finam-mcp
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"finam": {
"args": [
"finam-mcp-server@latest"
],
"command": "uvx",
"env": {
"FINAM_ACCOUNT_ID": "-account-id",
"FINAM_API_KEY": "-api-"
},
"type": "stdio"
}
}
}服务介绍
Finam MCP Server
MCP (Model Context Protocol) Finam Trade API.
MCP- Finam Trade API, AI-, Claude Desktop Cursor, .
Finam MCP Server :
- **** (macOS/Linux) | Command Prompt PowerShell (Windows)
- Python 3.12+ ( :
python3 --version) - uv ( )
:uv(,Homebrew)curl | sh - **Finam Trade API ** ( - )
- **MCP ** (Claude Desktop, Cursor, VS Code ..)
: MCP- MCP-, MCP-.
MCP-:
- Claude Desktop - :
uvx. Claude Desktop - Cursor - :
uvx. Cursor - VS Code - :
uvx. VS Code
**: **
- macOS Finder: Command + Shift + .
- Linux : Ctrl + H
- Windows File Explorer: Alt, V, H
- (macOS/Linux):
ls -a
: MCP- MCP-, MCP-.
# PyPI
uvx finam-mcp-server@latest
: uv, , uv/uvx . . : https://docs.astral.sh/uv/getting-started/installation/
** MCP-:**
** :**
- Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(Mac)%APPDATA%\Claude\claude_desktop_config.json(Windows) - Cursor:
~/.cursor/mcp.json(Mac/Linux)%USERPROFILE%\.cursor\mcp.json(Windows)
{
"mcpServers": {
"finam": {
"command": "uvx",
"args": ["finam-mcp-server@latest"],
"env": {
"FINAM_API_KEY": "-api-",
"FINAM_ACCOUNT_ID": "-account-id"
}
}
}
}
:
git clone https://github.com/Alexander-Panov/finam-mcp.git
cd finam-mcp
:
# uv ()
uv sync
# pip
pip install -e .
/ :
finam-mcp/ ( )
src/
__init__.py
cli.py
config.py
main.py MCP-
middleware.py Middleware
servers/ MCP-
account.py
assets.py
market_data.py
order.py
tradeapi/ Finam Trade API
finam.py
order/
tests/
.venv/
fastmcp.json FastMCP
pyproject.toml
README.md
LICENSE
API
- Finam Trade
-
- ( )
- API "API"
Finam Trade API:
-
- ,
-
- , ,
-
-
- , -
- ( )
-
Finam? -
Finam. - 10 .
- 5 150 .
- .
-
.
-
5 . -
? -
. -
. - 5- 2 .
-
SBER@MOEX. -
. -
.
get_account_info()-get_transactions()-get_trades()-
get_assets()-get_asset_params()-get_exchanges()-get_exchange_info()-get_option_boards()-get_trade_schedule()-
get_candles()-get_quotes()-get_order_book()-get_last_trades()-
get_orders()-place_order()- (market, limit, stop)cancel_order()-cancel_all_orders()-
MCP
Finam MCP MCP .
: uvx ()
** :**
-
Claude Desktop Settings Developer Edit Config
-
:
{
"mcpServers": {
"finam": {
"type": "stdio",
"command": "uvx",
"args": ["finam-mcp-server@latest"],
"env": {
"FINAM_API_KEY": "-api-",
"FINAM_ACCOUNT_ID": "-account-id"
}
}
}
}
- Claude Desktop !
MCP Cursor: https://docs.cursor.com/context/mcp
JSON
~/.cursor/mcp.json (macOS/Linux) %USERPROFILE%\.cursor\mcp.json (Windows):
{
"mcpServers": {
"finam": {
"type": "stdio",
"command": "uvx",
"args": ["finam-mcp-server@latest"],
"env": {
"FINAM_API_KEY": "-api-",
"FINAM_ACCOUNT_ID": "-account-id"
}
}
}
}
VS Code MCP GitHub Copilot.
: https://code.visualstudio.com/docs/copilot/chat/mcp-servers
1. MCP VS Code
- VS Code (Ctrl/Cmd + ,)
- "chat.mcp.enabled" MCP
- "github.copilot.chat.experimental.mcp"
2. MCP ( uvx)
: ** workspace** (.vscode/mcp.json) .
** workspace:**
.vscode/mcp.json- Finam MCP mcp.json:
```json
{
"mcp": {
"servers": {
"finam": {
"type": "stdio",
"command": "uvx",
"args": ["finam-mcp-server@latest"],
"env": {
"FINAM_API_KEY": "-api-",
"FINAM_ACCOUNT_ID": "-account-id"
}
}
}
}
}
```
MCP Inspector
MCP Inspector :
npx @modelcontextprotocol/inspector
, : http://localhost:3000/mcp Finam API Account ID.
`@MIC`:
SBER@MOEX-GAZP@MOEX-- :
MOEX,SPBE
API ISO 8601:
2024-01-15T10:30:00Z2024-01-15T10:30:00+03:00
TimeFrame
finam_trade_api.instruments.TimeFrame:
M1,M5,M15,M30-H1,H4-D1-W1-
FastMCP
`fastmcp.json`:
# fastmcp.json
fastmcp run
#
fastmcp run fastmcp.json
# Inspector UI
fastmcp dev
- Python 3.12+
- FastMCP - MCP-
- FinamTradeApiPy - Python- Finam Trade API
[Issue](../../issues) .
MCP- Finam Trade API. Finam.
. . , AI-, .
MIT License - . LICENSE .
