🧠 mcp金融英特尔
*用于市场分析和洞察的金融情报MCP服务器*
______________________________________________________________________
🚀 概述
mcp-finance-intel 是一个 模型上下文协议（MCP） 服务器写入 python，旨在作为 金融情报端点 对两者 LLM 和 人类开发人员.
______________________________________________________________________
🧩 特性
| 工具 | 目的 | 示例用法 |
|---|---|---|
quote | 获取加密货币或股票的当前价格、24小时变化率和交易量。 | 最新报价 BTC/USDT 和 AAPL. |
timeseries | 获取给定符号和间隔的OHLCV蜡烛。 | 检索90天的每日酒吧。 |
analyze_asset | 使用多种分析模式计算高级分析——趋势、风险、指标。 | 60天完整分析 ETH/USDT. |
每个工具都会返回 已验证的JSON输出, 来源支票和，并包括 "not_investment_advice": true.
______________________________________________________________________
🧠 分析模式（用于 analyze_asset)
| 模式 | 描述 | 包含的指标 |
|---|---|---|
basic | 简单的技术概述。 | SMA（20/50）、RSI（14）、波动率、夏普指数、MDD |
technical | 增加更深层次的技术指标。 | +EMA（20/50）、MACD（12,26,9）、ATR（14）、布林带（20,2） |
risk_plus | 添加高级风险度量。 | +排序、风险值（95%）、CVaR（95%） |
full | 结合了技术和风险指标。 | 以上所有 |
______________________________________________________________________
🏗️ 项目结构
mcp-finance-intel/
├─ adapters/
│ ├─ ccxt_adapter.py # Crypto data (Binance via ccxt)
│ └─ yfinance_adapter.py # Equity data (Yahoo Finance)
├─ analytics/
│ ├─ indicators.py # SMA, EMA, RSI, MACD, ATR, BBands
│ └─ risk.py # Volatility, Sharpe, Sortino, VaR, CVaR
├─ tools/
│ ├─ quote.py # Implements quote_tool()
│ ├─ timeseries.py # Implements timeseries_tool()
│ └─ analyze_asset.py # Implements analyze_asset_tool()
└─ server.py # MCP FastMCP entry point and tool registration______________________________________________________________________
⚙️ 安装
1.克隆存储库
git clone https://github.com/your-org/mcp-finance-intel.git
cd mcp-finance-intel2.创建虚拟环境
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate3.安装依赖项
pip install -r requirements.txt🧭 运行MCP服务器
▶️ HTTP传输（建议用于测试）
fastmcp run server.py:mcp --transport http --port 8000服务器将在以下位置可用： http://localhost:8000
▶️ STDIO传输（用于LLM集成）
fastmcp run server.py:mcp --transport stdio服务器将在以下位置可用： http://localhost:8000
HTTP有效负载示例
每个请求都遵循JSON-RPC 2.0格式。 确保您同时设置了以下两项：
- 内容类型：应用程序/json
- 接受：应用程序/json
引用
帖子->http://localhost:8000/mcp\ 身体
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "quote",
"arguments": {
"input": {
"symbols": ["BTC/USDT", "AAPL"]
}
}
}
}响应
{
"result": {
"structuredContent": {
"results": [
{
"symbol": "BTC/USDT",
"last": 104512.25,
"change_24h_pct": -2.35,
"volume_24h": 38512.7,
"source": "ccxt:binance",
"asof": "2025-10-20T11:35:00+00:00",
"bars_used": 1,
"checksum": "..."
},
{
"symbol": "AAPL",
"last": 247.45,
"change_24h_pct": -0.75,
"volume_24h": 39698000,
"source": "yfinance",
"asof": "2025-10-20T11:35:02+00:00",
"bars_used": 2,
"checksum": "..."
}
],
"not_investment_advice": true
}
}
}时间序列
帖子->http://localhost:8000/mcp\ 身体
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "timeseries",
"arguments": {
"input": {
"symbol": "BTC/USDT",
"interval": "1h",
"limit": 120
}
}
}
}响应（截断）
{
"result": {
"structuredContent": {
"symbol": "BTC/USDT",
"interval": "1h",
"bars_used": 120,
"source": "ccxt:binance",
"bars": [
{
"timestamp": 1734703200000,
"open": 103412.5,
"high": 104011.0,
"low": 103122.2,
"close": 103982.4,
"volume": 1845.1
}
],
"not_investment_advice": true
}
}
}分析资产
帖子->http://localhost:8000/\ 身体
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "analyze_asset",
"arguments": {
"input": {
"symbol": "ETH/USDT",
"interval": "1d",
"limit": 60,
"mode": "full"
}
}
}
}
回应（摘录）
{
"result": {
"structuredContent": {
"symbol": "ETH/USDT",
"window_used_bars": 60,
"trend_regime": "down",
"window_return": -0.16509,
"volatility_annualized": 0.55352,
"sharpe": -1.114,
"max_drawdown": -0.2246,
"rsi_last": 45.63,
"summary": "ETH/USDT (60bars 1d) regime: down. Window ret: -16.51%. Ann. vol: 55.35%, Sharpe: -1.11, Max DD: -22.46%. RSI(14): 45.6. | MACD hist: -18.84 | ATR(14)/P: 6.19% | %B: 0.35 | Sortino: -1.42 | VaR95 (hist): -5.65%. Signals are indicative only.",
"indicators": {
"ema20": 4114.65,
"ema50": 4262.51,
"macd": -108.56,
"atr14": 249.59,
"bb_percent": 0.35
},
"risk_extras": {
"sortino": -1.425,
"var_hist_95": -0.05649,
"cvar_95": -0.0916
},
"source": "ccxt:binance",
"asof": "2025-10-20T13:07:46+00:00",
"meta": {
"interval": "1d",
"limit": 60,
"units": {
"window_return": "fraction",
"volatility_annualized": "fraction",
"max_drawdown": "fraction",
"sharpe": "unitless"
}
},
"not_investment_advice": true
}
}
}
支持的间隔
1米、3米、5米、15米、30米， 1小时、2小时、4小时、6小时、8小时、12小时， 1d、3d、1w、1wk、1M、1mo
对于股票（融资），只支持1d、1h和1wk。
🔒 来源
每个结果包括：
- 截至：ISO-8601 UTC时间戳
- 来源：“ccxt:binance”或“yfinance”
- 校验和：序列化结果的SHA-256哈希->确保完整性和可重复性。
⚠️ 免责声明
本项目仅用于教育和分析目的。 所有回复包括 "not_investment_advice": true — 请勿用于实时交易或财务决策。
计划的功能
- 为RSI、MACD、ATR等指标添加自定义蜡烛
compare_assets,portfolio_analyze,news_digest- 缓存、LLM摘要、SQLite持久性
- 完全符合OpenMCP标准
Claude桌面配置
视窗
{
"mcpServers": {
"finance-intel": {
"command": "C:\\PATH_TO_PROJECT\\.venv\\Scripts\\fastmcp.exe",
"args": [
"run",
"C:\\PATH_TO_PROJECT\\mcp-finance-intel\\server.py:mcp"
],
"cwd": "C:\\PATH_TO_PROJECT\\mcp-finance-intel"
}
}
}Linux
{
"mcpServers": {
"finance-intel": {
"command": "/ABSOLUTE/PATH/TO/mcp-finance-intel/.venv/bin/fastmcp",
"args": [
"run",
"server.py:mcp"
],
"cwd": "/ABSOLUTE/PATH/TO/mcp-finance-intel"
}
}
}🐳 可选：在Docker中运行
您可以在容器化环境中运行MCP服务器：
FROM python:3.12-slim
WORKDIR /app
COPY . .
RUN pip install --no-cache-dir -r requirements.txt
EXPOSE 8000
CMD ["python", "server.py"]构建与运行
docker build -t mcp-finance-intel .
docker run -p 8000:8000 mcp-finance-intel☕ 支持项目
如果你喜欢使用 mcp金融英特尔 并想帮助我继续建设，\ 你可以在这里支持我：
👉 给我买杯咖啡