快速入门指南

先决条件

• Python 3.9+
• MongoDB运行在localhost:27017，数据库名为stock_data
• Alpha Vantage API密钥（免费支持，获取API密钥）
• Claude桌面应用（下载地址）

安装步骤

1. 克隆仓库并进入目录：

   git clone <repository-url>
   cd stock-mcp-server
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 创建.env文件并编辑配置：

   cp .env.example .env
   

   示例配置：

   MONGODB_URI=mongodb://localhost:27017
   MONGODB_DB_NAME=stock_data
   ALPHA_VANTAGE_API_KEY=your_api_key_here
   ALPHA_VANTAGE_DEFAULT_EXCHANGE=NSE
   

启动服务器

运行以下命令启动MCP服务器：

python server.py

配置Claude桌面应用

1. 编辑Claude配置文件（macOS路径：~/Library/Application Support/Claude/claude_desktop_config.json，Windows路径：%APPDATA%\Claude\claude_desktop_config.json）。
2. 添加MCP服务器配置：

   {
     "mcpServers": {
       "stock-analysis-mcp": {
         "command": "/path/to/python",
         "args": ["/path/to/server.py"],
         "cwd": "/path/to/stock_mcp_server",
         "env": {
           "ALPHA_VANTAGE_API_KEY": "your_api_key_here",
           "MONGODB_URI": "mongodb://localhost:27017",
           "MONGODB_DB_NAME": "stock_data"
         }
       }
     }
   }
   

3. 启动或重启Claude桌面应用。
4. 测试连接，例如询问："我的投资组合概要是什么？"