Global Data MCP
Provides Reddit sentiment analysis by retrieving posts from wallstreetbets, stocks, and investing subreddits that mention a given stock ticker.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Global Data MCP
美股 + 宏观舆情工具集的独立 MCP(Model Context Protocol)服务。从 Athena 的 py-sidecar 中抽取, 让任何 MCP 客户端(Claude Desktop、Kimi Code、Cursor、自研 Agent) 都能直接获取美股行情/财报、宏观指标、社交媒体舆情与预测市场数据。
工具清单(14 个)
美股(yfinance)
工具 | 说明 |
| 美股 OHLCV 日线历史(CSV:Date,Open,High,Low,Close,Volume) |
| 公司基本面:市值、PE、EPS、营收、利润率、ROE 等 20+ 字段 |
| 资产负债表(季度/年度) |
| 现金流量表(季度/年度) |
| 利润表(季度/年度) |
| 内部人(高管/大股东)买卖记录 |
| 个股相关新闻(标题 + 发布时间) |
宏观 / 舆情
工具 | 说明 | 数据源 |
| FRED 宏观指标:联邦基金利率、CPI、GDP、失业率、国债收益率、VIX 等(支持别名) | FRED(需 |
| 宏观市场新闻(SPY/QQQ/DIA 聚合,支持 topic 过滤) | yfinance |
| 7x24 全球财经快讯(标题 + 摘要 + 时间) | 东方财富 |
| Polymarket 预测市场概率(如 "Fed rate cut"、"recession 2026") | Polymarket gamma API |
| Reddit 舆情:wallstreetbets/stocks/investing 三板块提及个股的帖子 | Reddit RSS(零依赖) |
| StockTwits 消息流,含 Bullish/Bearish 标签统计 | StockTwits API(零依赖) |
| 技术指标:rsi/macd/boll/atr/sma/ema/vwma/mfi 等 13 个 | stockstats + yfinance |
所有工具均为秒级 HTTP 数据获取,同步调用,带本地 JSON 缓存
(DATA_CACHE_DIR,默认 TTL 300s)。
Related MCP server: finance-mcp
快速开始
pip install -r requirements.txt
python3 server.py --port 50058验证:
curl http://127.0.0.1:50058/health
curl http://127.0.0.1:50058/tools
# MCP initialize
curl -X POST http://127.0.0.1:50058/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'
# 真实调用
curl -X POST http://127.0.0.1:50058/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"get_stock_data",
"arguments":{"symbol":"AAPL","start_date":"2026-08-01","end_date":"2026-09-01"}}}'接入 MCP 客户端(以 Claude Desktop / Kimi Code 为例):
# mcp 配置
global-data:
url: http://127.0.0.1:50058/mcpDocker 部署
无需本地 Python 环境,一条命令起服务:
docker compose up -d # 构建镜像 + 启动容器(首次构建约 3-5 分钟)
docker compose ps # 查看状态
docker compose logs -f # 跟踪日志验证:
curl http://127.0.0.1:50058/health
curl http://127.0.0.1:50058/tools # 应返回 14 个工具license 鉴权(可选):在 docker-compose.yml 中取消 license 相关注释,
把宿主机 licenses.json 挂进容器并设置 MCP_LICENSE_FILE:
environment:
MCP_LICENSE_FILE: /app/licenses/licenses.json
volumes:
- ./licenses.json:/app/licenses/licenses.json:ro其他环境变量(FRED_API_KEY / YAHOO_PROXY / MCP_WORKERS 等)同样在
compose 文件的 environment 段配置,改完 docker compose up -d 生效。
注意容器内访问宿主机代理用 host.docker.internal(如
YAHOO_PROXY=socks5://host.docker.internal:1097)。
环境变量
变量 | 说明 |
| yfinance 专用代理(如 |
| FRED 宏观数据 API key, |
| 工具结果缓存目录(默认 |
| 缓存秒数(默认 300) |
附带:yahoo_quotes.py
Yahoo 美股实时行情子进程脚本(Go 行情网关以子进程方式调用):
echo '["AAPL","NVDA"]' | python3 yahoo_quotes.py
# 输出 JSON: [{symbol, name, price, prev_close, pct, volume, high, low, turnover}, ...]自带 60s 缓存(.yahoo_cache.json)防 Yahoo 限流;YAHOO_PROXY 同样生效。
鉴权与额度(可选)
默认开放模式(本地/内网)。设置环境变量后强制 license key 鉴权:
export MCP_LICENSE_FILE=/path/to/licenses.json
python3 server.py --port 50058
# 客户端请求头:X-License-Key: <key>license JSON 格式与额度语义见 mcp_gateway.py docstring。GET /quota 查余量。
端点一览
GET /health 健康检查
GET /tools 工具 JSON schema 列表
POST /mcp MCP JSON-RPC(initialize / tools/list / tools/call)
GET /quota license 额度余量(鉴权模式)
GET /metrics Prometheus 指标(文本格式,不鉴权)可观察性 / Observability
GET /metrics 输出 Prometheus 文本格式(text/plain; version=0.0.4),
不要求鉴权(内网抓取惯例;只含工具名级聚合,不泄露 license key)。
指标:
指标 | 类型 | 说明 |
| counter | 调用计数;status ∈ |
| counter | 延迟总和与样本数,相除即平均延迟 |
| gauge | 进程启动至今秒数 |
Prometheus scrape 配置示例:
scrape_configs:
- job_name: global-data-mcp
metrics_path: /metrics
static_configs:
- targets: ["127.0.0.1:50058"]数据源说明
yfinance:Yahoo Finance 非官方接口,有频率限制;生产建议挂代理 + 依赖内置缓存
FRED:圣路易斯联储官方 API,免费 key,稳定
Reddit / StockTwits:公开 RSS/API,无需 key,stdlib urllib 直连
Polymarket:gamma 公开搜索 API,无需 key
东方财富快讯:内置全局节流(≥1s 间隔 + 随机抖动 + 会话复用重试)防封 IP
致谢
本项目主体来自 Athena —— local-first、AI-native 的多 Agent 量化交易系统。
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
75 MCP tools: SEC financials, FRED economics, IRS 990, FDA, FX, UK Companies House.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Your agent needs markets — prices and fundamentals for listed companies, the filings behind them, crypto, and what the prediction markets put the odds at. **What you can ask for** • "Pull this company's income statement, cash flow and balance sheet for the last 8 quarters." • "What did insiders buy or sell, and when?" • "Snapshot prices for these 50 tickers, then the OHLC history for the three that moved." • "What are the current odds on this event across Kalshi and Polymarket?" • "Screen for companies matching these financial criteria." **How to use it** Point any MCP client at https://mcp.aisa.one/finance/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: prices and snapshots, income statements, balance sheets and cash flows, metrics and ratios, earnings and analyst estimates, filings and line-item search, insider trades, macro interest rates, news, a screener; CoinGecko spot prices, market tables, OHLC, per-venue tickers and trending; Kalshi and Polymarket markets and trades; plus EDINET filings for Japan. **Why this rather than the source** Equities, crypto and event markets behind one account, so a cross-asset question is one conversation. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the number here, then ask the same agent what X is saying about the ticker today — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/marketpulse/mcp · /crypto-market-data/mcp · /prediction-market-data/mcp · /stock-pulse/mcp for one slice each.
Your agent needs company financials it can compute on — statements, ratios, earnings, estimates, filings and insider activity as structured data, not a PDF. **What you can ask for** • "Give me 8 quarters of income statement, balance sheet and cash flow for this ticker." • "What do analysts estimate for next quarter, and how did the last four surprise?" • "Find this exact line item across every filing." • "Who bought or sold as an insider in the last 90 days?" • "Screen for profitable companies under this valuation with growing revenue." **How to use it** Point any MCP client at https://mcp.aisa.one/marketpulse/mcp and sign in with OAuth — there is no key to create or paste. 21 tools: prices and snapshots, income statements, balance sheets, cash-flow statements, financial metrics and snapshots, earnings, analyst estimates, company facts, filings and filing items, line-item search, a screener, insider trades, macro interest rates, news, plus EDINET documents and filing digests for Japanese issuers. **Why this rather than the source** Statements as fields you can compute on, and a screener in the same place. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the fundamentals here, then ask the same agent what social is saying about the ticker — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 10 financial data tools (market data, economic indicators, news, insider trades, and calendars) via a single MCP layer, enabling any MCP-compatible LLM to access diverse financial data through a unified interface.1MIT
- AlicenseAqualityCmaintenanceProvides live financial data for any LLM agent, including stock quotes, crypto prices, SEC filings, XBRL financials, FX rates, and macro indicators, through ten MCP tools.11109 npm1MIT
- FlicenseAqualityBmaintenanceEnables MCP clients to retrieve stock market and company financial data, including quotes, overviews, ratios, historical prices, income statements, and stock comparisons, via a set of tools.7-
- FlicenseNot gradedqualityAmaintenanceEnables MCP clients to retrieve Tiingo financial data through tools for stock prices, news, forex, fundamentals, dividends, and splits.-