Stock Market MCP Server

股票市场MCP服务器

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

特性

• 股票代码查找
• 实时股票价格
• 基本财务指标
• 市场和公司新闻
• 历史价格数据（蜡烛）
• 常见分析任务的预构建提示

先决条件

• Python 3.8或更高版本
• 紫外线 -快速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是一个快速、可靠的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. 启动克劳德桌面
2. 前往“设置”>“开发人员”
3. 启用“开发人员模式”
4. 点击“添加工具”
5. 选择“本地MCP服务器”
6. 配置工具：

- 名称：股票市场 - 命令：Python可执行文件和脚本的完整路径 - 例子： /Users/username/.venv/bin/python /Users/username/stock-market-mcp-server/stock-market-server.py - 工作目录：项目目录的完整路径

1. 点击“保存”

现在，你可以在与克劳德的对话中使用股市工具了！

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

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

与股票市场客户一起使用

要将MCP服务器与股票市场客户端一起使用，请执行以下步骤：

1. 您将需要一个Anthropic API密钥。你可以在以下网址免费获得一个 Anthropic.
2. 更新 _.env_ 使用API密钥提交。 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. 查找股票代码:

“你能查一下苹果的股票代码吗？”

1. 获取当前股价:

“AAPL目前的价格是多少？”

1. 使用提示:

“我想把特斯拉股票作为一项潜在的投资进行分析。”

1. 组合多种工具:

“给我一个市场概述，包括苹果、微软和特斯拉的最新消息和当前价格。”

故障排除

• API关键问题：请确保您的Finnhub API密钥在 .env.local 文件
• 未找到模块错误：确保您已激活虚拟环境并安装了所有依赖项
• 连接问题：检查您的互联网连接和Finnhub API状态

许可证

MIT许可证