Stock Market MCP Server

股票市场 MCP 服务

一个使用 Finnhub API 提供股票市场数据和分析工具的机器对话协议（MCP）服务。

功能

• 股票代码查询
• 实时股价
• 基本财务指标
• 市场和公司新闻
• 历史价格数据（K 线）
• 用于常见分析任务的预置提示词

前提条件

• Python 3.8 或更高版本
• uv - 快速的 Python 包安装器和解析器
• Finnhub API 密钥（可在 finnhub.io 免费获取）
• Claude Desktop（用于通过 Claude 使用 MCP 服务）

设置说明

1. 克隆代码库

git clone https://github.com/yourusername/stock-market-mcp-server.git
cd stock-market-mcp-server

2. 使用 uv 设置环境

uv 是一款快速、可靠的 Python 包安装器和虚拟环境管理器。以下是设置环境的方法：

# Install uv if you don't have it already
pip install uv

# Create a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
# .venv\Scripts\activate

# Install dependencies
uv add -r requirements.txt

3. 配置环境变量

在项目根目录中创建一个 .env.local 文件，并填入你的 Finnhub API 密钥：

FINNHUB_API_KEY=your_api_key_here

将 your_api_key_here 替换为你的 Finnhub API 密钥。

运行 MCP 服务

启动 MCP 服务：

uv run stock-market-server.py

服务默认以 stdio 模式运行，这意味着它会从标准输入读取内容，并向标准输出写入内容。

与 Claude Desktop 搭配使用

要将此 MCP 服务与 Claude Desktop 搭配使用：

1. 启动 Claude Desktop
2. 前往“设置”>“开发者”
3. 启用“开发者模式”
4. 点击“添加工具”
5. 选择“本地 MCP 服务”
6. 配置工具：
   • 名称：Stock Market
   • 命令：Python 可执行文件和脚本的完整路径
     • 示例：/Users/username/.venv/bin/python /Users/username/stock-market-mcp-server/stock-market-server.py
   • 工作目录：项目目录的完整路径
7. 点击“保存”

现在，你可以在与 Claude 的对话中使用股票市场工具了！

或者，你也可以手动将该工具添加到 Claude Desktop 的工具列表中。 你可以在 Claude Desktop 的安装目录中找到配置文件。在 MacBook Pro 上， 该文件位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json。 将以下 JSON 添加到 tools 数组中，注意修改路径以适应你的环境：

"stock-market": {
   "command": "uv",
   "args": [
     "--directory",
     "<YOUR_PATH_GOES_HERE>/stock-market-mcp-server",
     "run",
     "stock_market_server.py"
   ]
 }

与 Stock Market Client 搭配使用

要将 MCP 服务与 Stock Market Client 搭配使用，请按以下步骤操作：

1. 你需要一个 Anthropic API 密钥。可在 Anthropic 免费获取。
2. 使用你的 API 密钥更新 .env 文件。 ANTHROPIC_API_KEY=your_api_key_here
3. 使用以下命令启动 MCP 客户端：uv run stock_market_client.py

可用工具

MCP 服务提供以下工具：

• get_stock_symbol_lookup：按公司名称搜索股票代码
• get_stock_price：获取某只股票的最新价格
• get_basic_financials：获取公司的关键财务指标
• get_market_news：按类别获取最新市场新闻
• get_company_news：获取特定公司在某个日期范围内的新闻
• get_stock_candles：获取某只股票的历史价格数据

可用提示词

服务包含以下预置提示词：

• stock_analysis：分析某只股票的潜在投资价值
• market_overview：获取全面的市场概览
• stock_price_history：分析历史价格走势
• company_news_analysis：分析新闻及其对股价的影响

提示词使用示例

以下是一些使用 Claude 调用这些工具的示例：

1. 查询股票代码： “你能帮我查一下 Apple 的股票代码吗？”

2. 获取当前股价： “AAPL 当前价格是多少？”

3. 使用提示词： “我想分析 Tesla 股票是否值得投资。”

4. 组合使用多个工具： “请结合最新新闻和 AAPL、MSFT、TSLA 的当前价格，为我提供市场概览。”

故障排除

• API 密钥问题：确保已在 .env.local 文件中正确设置 Finnhub API 密钥
• 找不到模块错误：确保已激活虚拟环境并安装所有依赖项
• 连接问题：检查互联网连接和 Finnhub API 状态

许可证

MIT 许可证