SocialForex

io.github.namlxuit056由 GitHub 帳號 namlxuit056 發布v0.1.0更新於 Oct 24, 2026

Live forex, gold & crypto quotes, economic calendar, screener, currency strength, lot-size calc

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取金融資料與分析

概覽

AI 產生的概覽

提供即時外匯、黃金與加密貨幣報價、經濟行事曆、技術面篩選、貨幣強弱、交易時段與部位大小計算的交易資訊 MCP 伺服器。

可以做什麼
取得外匯主要與次要貨幣對、黃金、白銀、原油及加密貨幣的即時買賣價與當日漲跌幅。查詢即將到來或近期的總體經濟事件，含影響程度、預測值、前值與實際值（UTC 時間）。依 M15、H1、H4、D1 取得各商品的技術面評級、RSI、ADX、MACD、布林通道位置、隨機指標與 ATR。比較八大主要貨幣的相對強弱並由強至弱排序。確認外匯市場是否開盤、目前與即將到來的交易時段重疊。依停損與風險百分比計算部位手數。
適用情境
當你想在對話中快速查看外匯、黃金、能源與加密貨幣報價、宏觀事件行程、技術面評級、貨幣強弱或交易時段，或需要依風險百分比計算下單手數時使用。適合行情瀏覽與交易前的資訊整理。
執行需求
遠端 MCP 端點，無需本機安裝或套件；不需帳號、API 金鑰或環境變數。需能連線至該服務的網路。
安裝前請注意
內容僅供教育與資訊參考，伺服器本身要求助理提醒這不是投資建議。槓桿商品交易風險高；報價、技術評級與強弱數據可能延遲或有誤，不宜作為唯一決策依據。部位計算假設帳戶幣別為美元。資料由第三方服務提供。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SocialForex，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.namlxuit056%2Fsocial-forex/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "socialforex": {
      "type": "http",
      "url": "https://toolforex.xyz/api/mcp"
    }
  }
}

README

SocialForex

Forex tools, signals, journal and community for traders — open source.

[Live site] [License: AGPL v3] [Support with PayPal] [Sponsor]

👉 Try it live: toolforex.xyz

Tiếng Việt · Features · Self-hosting · Sponsor

[SocialForex home page]

SocialForex is a full-stack trading companion for retail forex / gold / crypto traders. It combines live market data, a community signal room, MT5 copy-trading, a deep trading journal with AI reviews, and an academy for beginners — in Vietnamese and English.

⚠️ Everything in this project is for education and information only. It is not investment advice. Trading leveraged products carries a high risk of losing money.

Features

📈 Market data

Live quotes — forex, metals, energy and crypto, auto-refreshing
[圖片]		TradingView chart with watchlist and AI expert analysis
[圖片]
Market screener — M15/H1/H4/D1 ratings, RSI, ADX per pair
[圖片]		Currency-strength heatmap across 8 majors
[圖片]
Economic calendar — VN/UTC time, impact filters, AI explanation
[圖片]		Live desk — chart + news risk + lot sizing before every trade
[圖片]

📡 Signals & community

Signal room — free and VIP signals, MT5-verified, comments & votes
[圖片]		Confident technical signals — 4H Strong confirmed by H1 + M15, accuracy tracked per source (TradingView, CFTC COT, OANDA, Myfxbook, IG)
[圖片]
Leaderboard — win rate, profit factor, XP; follow or copy
[圖片]		Community sentiment — long/short ratio from active signals
[圖片]
MT5 copy-trading — Expert Advisor with fixed-lot / %-risk sizing
[圖片]		MT5 positions — live P/L, auto-close before weekend / end of day / at breakeven, AI portfolio review
[圖片]

📒 Trading journal & discipline

Trading journal — auto-synced from MT5, win rate, payoff, expectancy
[圖片]		Advanced stats — discipline scorecard, tilt days, mistake tags, MAE/MFE, weekly & daily AI reviews
[圖片]
Daily trading plan — pre-trade checklist, risk limits, streaks
[圖片]		AI Auto-Scalp — multi-symbol scalping analysis with quality thresholds
[圖片]
Price alerts with web push notifications
[圖片]		Dashboard — daily activity, XP level, referral program
[圖片]

🎓 Learning

Academy / Wiki — price action path from beginner to advanced
[圖片]		AI forex articles — daily analysis enriched with web search and chart snapshots
[圖片]
Beginner mission board — 16 auto-verified tasks with XP
[圖片]		Calculators — position size, pivot points, margin
[圖片]
Backtest — Monte Carlo equity simulation
[圖片]		Dark mode & mobile-first
[圖片] [圖片]

Screenshots are regenerated with node scripts/screenshots.mjs (account balances are blurred automatically).

🤖 Use it from your AI assistant (MCP)

SocialForex is also a public MCP server — quotes, economic calendar, screener, currency strength, trading sessions and a position-size calculator, right inside Claude, Cursor, VS Code or DeepSeek Harness:

bash
claude mcp add --transport http socialforex https://toolforex.xyz/api/mcp

See docs/mcp.md for the tool list and other clients.

[An AI assistant answering "Any BTC signal?" with live SocialForex screener data over MCP]
Asking an assistant "BTC có tín hiệu gì không?" — it calls the SocialForex MCP tools and answers from live screener data.

Tech stack

  • Next.js 16 (App Router) + React 19, Tailwind CSS v4 + shadcn/ui
  • Prisma 7 + PostgreSQL
  • NextAuth v5 (credentials, JWT sessions)
  • next-intl v4 — Vietnamese (default) and English
  • AI providers: DeepSeek, Groq, OpenAI or Anthropic (configurable in the admin panel)
  • MetaTrader 5 Expert Advisors for copy-trading and position bridging (docs/mt5)
  • Vitest unit tests, Playwright end-to-end tests

Getting started

Requirements: Node.js 20+, Docker (for PostgreSQL).

bash
git clone https://github.com/namlxuit056/social-forex.gitcd social-forexnpm installcp .env.example .env          # then fill in DATABASE_URL and AUTH_SECRETnpm run docker:up             # start PostgreSQLnpm run db:deploy             # apply migrationsnpm run db:seed               # optional sample datanpm run dev                   # http://localhost:3000

Only DATABASE_URL, AUTH_SECRET and NEXTAUTH_URL are required. Every other key in .env.example (AI providers, Telegram, PayPal, OANDA, Myfxbook, Vercel Blob…) turns on an optional feature.

Useful commands:

bash
npm run lint      # ESLintnpm test          # Vitestnpm run build     # production build

Self-hosting on your own machine with pm2 + Cloudflare Tunnel is documented in docs/self-hosting.md.

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md. Please report security problems privately as described in SECURITY.md.

Support the project

SocialForex is built and run by one developer and hosted at toolforex.xyz. If it helps your trading, you can support hosting, data and AI costs:

License

GNU AGPL-3.0. You may use, modify and self-host this project; if you run a modified version as a public service, you must publish your source code under the same license.

Tiếng Việt

SocialForex là nền tảng mã nguồn mở hỗ trợ trader forex / vàng / crypto: giá realtime, phòng tín hiệu cộng đồng, copy-trade MT5, nhật ký giao dịch có AI chấm điểm kỷ luật, lịch kinh tế, screener, heatmap và học viện cho người mới.

Mọi nội dung chỉ mang tính giáo dục, không phải lời khuyên đầu tư.

來源：README.md，提交 97bc8da

工具

6

get_quotes

Live quotes

Current bid/ask and daily % change for forex majors/minors, gold, silver, oil and crypto.

輸入參數symbols

get_economic_calendar

Economic calendar

Upcoming (and optionally recent) macro events with impact, forecast, previous and actual values. Times are UTC.

輸入參數hoursBackminImpactcurrencieshoursAhead

get_screener

Technical screener

Per-symbol technicals: TradingView recommendation per timeframe (M15/H1/H4/D1, -1 strong sell … +1 strong buy), RSI, ADX, MACD, Bollinger position, stochastic state and ATR.

輸入參數symbols

get_currency_strength

Currency strength

Relative strength of the 8 major currencies, derived from today's % change across available pairs. Sorted strongest first.

無需輸入參數。

get_market_sessions

Trading sessions

Whether the forex market is open, active sessions (Sydney/Tokyo/London/New York), current and upcoming overlaps.

無需輸入參數。

calculate_position_size

Position size calculator

Lot size so that hitting the stop loss loses `riskPct` % of the balance. Account currency is assumed to be USD.

輸入參數entry必填symbol必填balance必填riskPct必填leveragestopLoss必填

版本歷史

1
  1. v0.1.0最新Oct 24, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分