使用说明
金融MCP服务器
MCP(模型上下文协议)服务器,为Claude Code和其他MCP兼容的AI助手提供财务数据。
支持 美国股票, 日本股市(TSE),以及 EDINET文件.
特性
| 工具 | 描述 | 来源 |
|---|---|---|
get_stock_price |
当前股价、变动、成交量 | y融资 |
get_stock_history |
历史OHLCV数据 | 金融 |
get_company_info |
公司简介和摘要 | y财务 |
get_financial_statements |
损益表/资产负债表/现金流量表 | |
get_basic_financials |
关键指标(市盈率、市盈率、净资产收益率等) | Finnhub |
get_company_news |
公司特定新闻文章 | Finnhub |
get_market_news |
一般市场新闻 | Finnhub |
search_edinet_documents |
按日期搜索EDINET文件 | EDINET |
get_edinet_document_info |
EDINET文档元数据 | EDINET |
get_edinet_financial_data |
下载并解析EDINET CSV数据 | EDINET |
数据源
| API | 它提供什么 | Auth | 速率限制 |
|---|---|---|---|
| 雅虎财经 | 股票价格、公司信息、财务报表 | 无需 | 非官方(可能限制) |
| Finnhub | 新闻、财务指标 | 免费API密钥 | 60次呼叫/分钟 |
| 埃迪内 | 日本公司备案 | 免费API密钥 | 未指定 |
快速开始
1.克隆和安装
git clone https://github.com/rata-a2/Finance-MCP.git
cd Finance-MCP
pip install -e .
2.获取API密钥(免费)
- Finnhub:注册地址: finnhub.io/register
- 埃迪内:注册地址 disclosure.edinet-fsa.go.jp
注:金融工具在没有任何API密钥的情况下工作。
3.配置克劳德代码
添加到您的Claude Code MCP设置中:
{
"mcpServers": {
"finance": {
"command": "python",
"args": ["/path/to/Finance-MCP/run_server.py"],
"env": {
"FINNHUB_API_KEY": "your_finnhub_key",
"EDINET_API_KEY": "your_edinet_key"
}
}
}
}
或者创建一个 .env 项目根目录中的文件(请参见 .env.example).
用法示例
# US stock price
get_stock_price("AAPL")
# Japanese stock (Tokyo Stock Exchange)
get_stock_price("7203.T") # Toyota
get_stock_price("6758.T") # Sony
# Historical data
get_stock_history("MSFT", period="3mo", interval="1d")
# Company news
get_company_news("AAPL", from_date="2025-01-01", to_date="2025-01-31")
# Financial statements
get_financial_statements("GOOGL", statement_type="income")
# Key financial metrics
get_basic_financials("AAPL")
# EDINET (Japanese filings)
search_edinet_documents("2025-03-01", doc_type="120")
需求
- Python 3.11+
- 依赖关系:
mcp[cli],yfinance,finnhub-python,requests,python-dotenv
许可证
麻省理工学院