Financial Datasets

Financial Datasets MCP Server

Giới thiệu

Đây là một máy chủ Model Context Protocol (MCP) cung cấp quyền truy cập vào dữ liệu thị trường chứng khoán từ Financial Datasets.

Nó cho phép Claude và các trợ lý AI khác truy xuất báo cáo thu nhập, bảng cân đối kế toán, báo cáo lưu chuyển tiền tệ, giá cổ phiếu và tin tức thị trường trực tiếp thông qua giao diện MCP.

Công cụ có sẵn

Máy chủ MCP này cung cấp các công cụ sau:

• get_income_statements: Lấy báo cáo thu nhập cho một công ty.
• get_balance_sheets: Lấy bảng cân đối kế toán cho một công ty.
• get_cash_flow_statements: Lấy báo cáo lưu chuyển tiền tệ cho một công ty.
• get_current_stock_price: Lấy giá hiện tại / mới nhất của một công ty.
• get_historical_stock_prices: Lấy giá cổ phiếu lịch sử cho một công ty.
• get_company_news: Lấy tin tức cho một công ty.
• get_available_crypto_tickers: Lấy tất cả các mã tiền điện tử có sẵn.
• get_crypto_prices: Lấy giá lịch sử cho một loại tiền điện tử.
• get_historical_crypto_prices: Lấy giá lịch sử cho một loại tiền điện tử.
• get_current_crypto_price: Lấy giá hiện tại / mới nhất của một loại tiền điện tử.

Thiết lập

Điều kiện tiên quyết

• Python 3.10 trở lên
• Trình quản lý gói uv

Cài đặt

1. Sao chép kho lưu trữ này:

   git clone https://github.com/financial-datasets/mcp-server
   cd mcp-server
   

2. Nếu bạn chưa cài đặt uv, hãy cài đặt nó:

   # macOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Windows
   curl -LsSf https://astral.sh/uv/install.ps1 | powershell
   

3. Cài đặt các phụ thuộc:

   # Create virtual env and activate it
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   # Install dependencies
   uv add "mcp[cli]" httpx  # On Windows: uv add mcp[cli] httpx
   
   

4. Thiết lập biến môi trường:

   # Create .env file for your API keys
   cp .env.example .env
   
   # Set API key in .env
   FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
   

5. Chạy máy chủ:

   uv run server.py
   

Kết nối với Claude Desktop

1. Cài đặt Claude Desktop nếu bạn chưa có

2. Tạo hoặc chỉnh sửa tệp cấu hình Claude Desktop:

   # macOS
   mkdir -p ~/Library/Application\ Support/Claude/
   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

3. Thêm cấu hình sau:

   {
     "mcpServers": {
       "financial-datasets": {
         "command": "/path/to/uv",
         "args": [
           "--directory",
           "/absolute/path/to/financial-datasets-mcp",
           "run",
           "server.py"
         ]
       }
     }
   }
   

   Thay thế /path/to/uv bằng kết quả của which uv và /absolute/path/to/financial-datasets-mcp bằng đường dẫn tuyệt đối đến dự án này.

4. Khởi động lại Claude Desktop

5. Bây giờ bạn sẽ thấy các công cụ tài chính có sẵn trong menu công cụ của Claude Desktop (biểu tượng búa)

6. Thử hỏi Claude những câu hỏi như:

   • "Báo cáo thu nhập gần đây của Apple là gì?"
   • "Cho tôi xem giá hiện tại của cổ phiếu Tesla"
   • "Lấy giá lịch sử cho MSFT từ 2024-01-01 đến 2024-12-31"