Twelve Data MCP Server

Twelve Data MCP Server

Kết nối Claude, ChatGPT và các trợ lý AI khác với API tài chính Twelve Data — giá thời gian thực và lịch sử, hơn 60 chỉ báo kỹ thuật, dữ liệu cơ bản, lợi nhuận, cổ tức, ETF, tin tức công ty, cổ phiếu biến động mạnh nhất thị trường, và nhiều hơn nữa.

Bạn cần có tài khoản Twelve Data. Đăng ký tại twelvedata.com.

Có hai cách để sử dụng. Hầu hết mọi người nên dùng máy chủ đám mây (Tùy chọn 1) — không cần cài đặt gì cả.

---

Tùy chọn 1 — Dùng máy chủ đám mây của chúng tôi (khuyến nghị)

Kết nối trợ lý AI của bạn với máy chủ được lưu trữ sẵn của chúng tôi:

https://mcp.twelvedata.com/mcp

Chỉ vậy thôi. Không cần cài đặt, không cần sao chép và dán khóa API. Khi bạn kết nối, một cửa sổ trình duyệt sẽ mở ra và bạn đăng nhập bằng tài khoản Twelve Data của mình — khóa API cá nhân của bạn được liên kết tự động và gắn liền với tài khoản của bạn.

Cách thêm vào

Claude (Desktop / Web) và ChatGPT hỗ trợ trình kết nối tùy chỉnh / máy chủ MCP:

1. Mở cài đặt Trình kết nối (hoặc Tích hợp / Máy chủ MCP) của trợ lý.
2. Thêm một trình kết nối mới với URL https://mcp.twelvedata.com/mcp.
3. Khi được nhắc, nhấp Kết nối / Đăng nhập — một trang đăng nhập Twelve Data sẽ mở trong trình duyệt của bạn.
4. Ủy quyền, và bạn đã hoàn tất. Hãy hỏi những câu như "RSI của AAPL là bao nhiêu?" hoặc "Cho tôi xem lợi nhuận mới nhất của TSLA."

Tên menu chính xác có thể khác nhau giữa các ứng dụng và phiên bản, nhưng quy trình luôn giống nhau: thêm URL, sau đó đăng nhập qua cửa sổ bật lên của trình duyệt.

---

Tùy chọn 2 — Chạy cục bộ với khóa API của bạn

Bạn muốn chạy máy chủ trên máy của riêng mình (ví dụ: cho Claude Desktop qua stdio)? Bạn chỉ cần khóa API Twelve Data của mình — không cần thiết lập OAuth.

1. Lấy khóa API của bạn

Đăng nhập tại twelvedata.com → bảng điều khiển của bạn → Khóa API. Sao chép khóa của bạn.

2. Cài đặt

Yêu cầu Python 3.10+ (khuyến nghị 3.12; trên macOS brew install [email protected] hoặc make python-install).

make install

3. Thêm khóa API của bạn

Tạo một tệp .env trong thư mục gốc của dự án với khóa của bạn:

TWELVE_DATA_API_KEY=your_api_key_here

4. Kết nối với Claude Desktop

Thêm vào ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/twelve-data-mcp/.venv/bin/python",
      "args": ["/path/to/twelve-data-mcp/src/server.py"]
    }
  }
}

Sử dụng đường dẫn .venv/bin/python (không phải Python hệ thống — macOS đi kèm Python 3.9, và máy chủ này cần 3.10+). Khởi động lại Claude Desktop sau khi chỉnh sửa cấu hình.

Vậy là xong — máy chủ đọc khóa API của bạn từ .env và mọi yêu cầu đều sử dụng nó. Không cần bước đăng nhập.

---

Những gì bạn có thể hỏi

• Giá cả — cổ phiếu, ETF, ngoại hối, tiền điện tử, hàng hóa (thời gian thực & lịch sử)
• Chỉ báo kỹ thuật — RSI, MACD, SMA, BBANDS, ATR, và hơn 60 chỉ báo khác
• Dữ liệu cơ bản — báo cáo tài chính, lợi nhuận, cổ tức, chia tách cổ phiếu, hồ sơ công ty, vốn hóa thị trường, số liệu thống kê chính, lịch IPO
• Quỹ — hồ sơ ETF & quỹ tương hỗ, hiệu suất, danh mục nắm giữ, rủi ro
• Tin tức — tin tức công ty & thông cáo báo chí
• Thông tin thị trường — cổ phiếu biến động mạnh, tỷ giá hối đoái, xếp hạng của nhà phân tích, giá mục tiêu
• Quy định — hồ sơ SEC/EDGAR, giao dịch nội gián, sở hữu của tổ chức

Định dạng mã: cổ phiếu AAPL, tiền điện tử BTC/USD, ngoại hối EUR/USD.

---

Đối tác

Đang chạy phiên bản công khai của riêng bạn hoặc thiết lập đăng nhập OAuth chuyên dụng? Đó là thỏa thuận đối tác — hãy liên hệ với chúng tôi tại twelvedata.com và chúng tôi sẽ cung cấp hướng dẫn thiết lập và thông tin xác thực OAuth.