article
README
🚀 股票市场数据MCP服务器
这是一个提供来自Financial Datasets股票市场数据的模型上下文协议(MCP)服务器。它允许Claude和其他AI助手通过MCP界面直接获取收入报表、资产负债表、现金流量表、股票价格和市场新闻,为金融数据获取和分析提供了便捷途径。
🚀 快速开始
此MCP服务器提供了一系列实用工具,允许Claude和其他AI助手通过MCP界面获取金融数据。以下是使用前的准备工作和操作步骤。
✨ 主要特性
此MCP服务器提供以下工具:
- get_income_statements:获取公司的收入报表。
- get_balance_sheets:获取公司的资产负债表。
- get_cash_flow_statements:获取公司的现金流量表。
- get_current_stock_price:获取公司当前/最新的股票价格。
- get_historical_stock_prices:获取公司历史股票价格。
- get_company_news:获取公司的新闻。
- get_available_crypto_tickers:获取所有可用的加密货币交易对。
- get_crypto_prices:获取加密货币的历史价格。
- get_historical_crypto_prices:获取加密货币的历史价格。
- get_current_crypto_price:获取加密货币当前/最新的价格。
📦 安装指南
先决条件
- Python 3.10或更高版本
- uv包管理器
安装步骤
- 克隆此仓库:
git clone https://github.com/financial-datasets/mcp-server
cd mcp-server
- 如果尚未安装uv,请进行安装:
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
curl -LsSf https://astral.sh/uv/install.ps1 | powershell
- 安装依赖项:
# 创建虚拟环境并激活它
uv venv
source .venv/bin/activate # 在Windows上:.venv\Scripts\activate
# 安装依赖项
uv add "mcp[cli]" httpx # 在Windows上:uv add mcp[cli] httpx
- 设置环境变量:
# 复制示例文件并配置API密钥
cp .env.example .env
# 在.env文件中设置API密钥
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
- 运行服务器:
uv run server.py
📚 详细文档
配置Claude Desktop
- 如果尚未安装,请下载并安装Claude Desktop。
- 创建或编辑Claude Desktop配置文件:
# macOS
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
- 添加以下配置:
{
"mcpServers": {
"financial-datasets": {
"command": "/path/to/uv",
"args": [
"--directory",
"/absolute/path/to/financial-datasets-mcp",
"run",
"server.py"
]
}
}
}
请将/path/to/uv替换为which uv的输出结果,并将/absolute/path/to/financial-datasets-mcp替换为该项目的绝对路径。
4. 重启Claude Desktop。
5. 现在您应该可以在Claude Desktop工具菜单(锤子图标)中看到金融工具。
6. 您可以尝试让Claude回答以下问题:
- “Apple最近的收入报表是什么?”
- “显示特斯拉股票的当前价格”
- “获取MSFT从2024 - 01 - 01到2024 - 12 - 31的历史价格”
微信扫一扫