原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

FXMacroData

作者:fxmacrodata版本 1.0.1i★ –i在云端运行
注册名称io.github.fxmacrodata/fxmacrodata

安装

概览

作者提供的说明(英文原文)

Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

你需要

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

适用于网页版、桌面版和手机版 Claude:

  1. 打开 Settings → Connectors
  2. 点击 Add custom connector
  3. 粘贴下面的地址,然后点击 Add
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Add2https://…3
https://fxmacrodata.com/mcp

在终端中运行这条命令

claude mcp add --transport http fxmacrodata https://fxmacrodata.com/mcp

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "fxmacrodata": {
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "fxmacrodata": {
      "type": "http",
      "url": "https://fxmacrodata.com/mcp"
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

ChatGPT 只能连接互联网上的服务器:

  1. 打开网页版 ChatGPT → Settings → Connectors (Apps)
  2. 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
  3. 粘贴下面的地址,起个名字,然后保存
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Create2https://…3
https://fxmacrodata.com/mcp

菜单名称可能因套餐和版本不同而略有差异。

你的选择通过 Cookie 保存在这台设备上,无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

我们还没有读取这个服务器的工具列表;我们会轮流检查各个端点。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月6日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 fxmacrodata 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    端点有响应

    尚未检查;我们会轮流检查各个端点

  • … 尚未检查

    使用 OAuth 登录

    尚未检查;我们会轮流检查各个端点

  • … 尚未检查

    工具描述中没有隐藏指令

    尚未检查;我们会在检查端点时读取工具列表

与“其他”中的其他服务器比较i

  • 星标数多于此分类中其他 32433 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 32433 个服务器的 6% 更新
  • 基础检查结果等于或优于此分类中其他 32433 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

FXMacroData 安全吗?

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(1.0.1)于7个月前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。

有什么可以替代它?

同一分类中有:Spec Driven Development, Remote Desktop Commander, Symantec Cloud DLP AIops

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者:formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新
安装

Remote Desktop Commander

作者:desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211昨天更新
安装

Symantec Cloud DLP AIops

作者:AIops-tools

Governed Symantec Cloud DLP — 14 MCP tools, read-only with audit.

在你的电脑上运行今天更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

FXMacroData Python SDK 🐍📊

The FXMacroData Python SDK provides a simple and efficient interface for fetching macroeconomic indicators, forex prices, release calendars, COT positioning, and commodity prices from FXMacroData.

Use synchronous and asynchronous clients to bring the data into research notebooks, backtests and applications.

Subscribe to FXMacroData for non-USD data, full available history, FX, commodities and positioning. Use the public USD workflow to evaluate the integration before connecting your subscription.


🌟 Features

  • Fetch:
  • Macroeconomic indicators — policy rates, inflation, GDP, unemployment, bond yields, and more: 97 distinct indicators across 656 endpoints
  • FX spot rates with optional technical indicators (SMA, RSI, MACD, Bollinger Bands)
  • Release calendars — upcoming economic data release dates
  • Data catalogue — discover available indicators per currency
  • COT data — CFTC Commitment of Traders positioning
  • Commodity prices — gold, silver, platinum
  • Evaluate with public USD macro data covering the most recent 90 days; connect your FXMacroData subscription for full available history.
  • FX spot-rate history through get_fx_price.
  • A key from an authorized FXMacroData subscription is required for protected datasets, including non-USD indicators, FX spot-rate history, COT, and commodities.
  • Full support for:
  • Synchronous client
  • Asynchronous client
  • Lightweight: depends only on requests and aiohttp.

📦 Installation

Install from PyPI:

pip install fxmacrodata

Or install the latest version from GitHub:

pip install git+https://github.com/fxmacrodata/fxmacrodata.git

🔧 Usage

Synchronous
from fxmacrodata import Client

client = Client(api_key="YOUR_API_KEY")

Fetch macroeconomic indicators

data = client.get_indicator( "aud", "policy_rate", start_date="2023-01-01", end_date="2023-11-01" ) print(data)

Forex price endpoint

fx = client.get_fx_price("usd", "gbp", start_date="2025-01-01") print(fx)

Forex with technical indicators

fx = client.get_fx_price("eur", "usd", indicators="sma_20,rsi_14,macd") print(fx)

Release calendar

calendar = client.get_calendar("usd") print(calendar)

Data catalogue — discover available indicators

catalogue = client.get_data_catalogue("usd") print(catalogue)

COT positioning data

cot = client.get_cot("eur", start_date="2025-01-01") print(cot)

Commodity prices

gold = client.get_commodities("gold", start_date="2026-01-01") print(gold)


Asynchronous
import asyncio

from fxmacrodata import AsyncClient

async def main(): async with AsyncClient(api_key="YOUR_API_KEY") as client:

Fetch macroeconomic indicators

data = await client.get_indicator("eur", "inflation") print(data)

Forex price endpoint

fx = await client.get_fx_price("usd", "jpy") print(fx)

Release calendar

calendar = await client.get_calendar("usd") print(calendar)

Data catalogue

catalogue = await client.get_data_catalogue("usd") print(catalogue)

COT positioning

cot = await client.get_cot("jpy") print(cot)

Commodity prices

gold = await client.get_commodities("gold") print(gold)

asyncio.run(main())

Timeouts and errors

Every request has a 30-second timeout by default. Change it per client:

Client(api_key="YOUR_API_KEY", timeout=60)            # seconds

Client(api_key="YOUR_API_KEY", timeout=(3.05, 120)) # (connect, read) AsyncClient(api_key="YOUR_API_KEY", timeout=60) # total seconds

All errors are FXMacroDataError or one of its subclasses:

ExceptionRaised when
FXMacroDataAPIErrorThe API returns a non-200 status (.status_code is set).
FXMacroDataResponseErrorThe API returns 200 but the body is an error message or not a JSON object.
FXMacroDataTimeoutErrorThe request exceeds the timeout.
FXMacroDataTransportErrorThe connection fails (DNS, TLS, network).
FXMacroDataRedirectErrorA redirect would send your API key to a different origin, so it is refused.

Your API key is never included in error messages, and it is only sent over HTTPS to the origin you configured: redirects to another host or to plain HTTP are refused rather than followed with the key attached.


OpenBB Integration

FXMacroData supports all practical OpenBB integration paths from this package:

  • OpenBB Python: installable provider/router extension for obb.fxmacrodata.*.
  • OpenBB REST API: /api/v1/fxmacrodata/* routes through openbb-api.
  • OpenBB Workspace, generated: widgets generated by openbb-api from inline metadata.
  • OpenBB Workspace, custom: standalone backend serving widgets.json, apps.json, and data endpoints.
  • OpenBB MCP: tools exposed through openbb-mcp.
  • OpenBB CLI: commands available after openbb-build.

OpenBB packages require Python 3.10+. Install the OpenBB Python extra:

pip install "fxmacrodata[openbb]"

openbb-build

Then use FXMacroData from the OpenBB Python interface:

from openbb import obb

obb.user.credentials.fxmacrodata_api_key = "YOUR_API_KEY"

catalogue = obb.fxmacrodata.data_catalogue( currency="USD", provider="fxmacrodata", ).to_df()

inflation = obb.fxmacrodata.macro_indicators( currency="USD", indicator="inflation", start_date="2020-01-01", provider="fxmacrodata", ).to_df()

eurusd = obb.fxmacrodata.fx_historical( base="EUR", quote="USD", start_date="2024-01-01", provider="fxmacrodata", ).to_df()

Run the OpenBB REST API and generated Workspace backend:

pip install "fxmacrodata[openbb-api]"

openbb-build fxmacrodata-openbb-api --host 127.0.0.1 --port 6900

Workspace can be connected to http://127.0.0.1:6900. The generated /widgets.json uses FXMacroData's inline OpenBB widget metadata.

Run the OpenBB Workspace custom backend:

pip install "fxmacrodata[workspace]"

fxmacrodata-openbb-backend

Default backend URL:

http://127.0.0.1:7779

Workspace exposes /widgets.json, /apps.json, /catalogue, /release_calendar, /macro_indicator, /forex, /cot, and /commodity. Swagger/OpenAPI docs are disabled by default for this backend. For local debugging only, set FXMACRODATA_OPENBB_ENABLE_DOCS=1 before starting it.

Run OpenBB MCP:

pip install "fxmacrodata[mcp]"

openbb-build fxmacrodata-openbb-mcp --default-categories fxmacrodata --host 127.0.0.1 --port 8001

Run OpenBB CLI:

pip install "fxmacrodata[openbb-cli]"

openbb-build openbb

See docs/openbb-integration.md for the full integration matrix and the separate upstream OpenBB repository contribution path.


📘 API Overview

get_indicator(currency, indicator, start_date=None, end_date=None)

Fetches macroeconomic indicator time series data.

  • currency: "usd", "aud", "eur", "gbp", "cad", "nok", "nzd", "jpy", "brl", "cny", "dkk", "pln", "sek", "sgd", etc.
  • indicator: "policy_rate", "inflation", "gdp", "unemployment", "trade_balance", "current_account_balance", "gov_bond_10y", etc.
  • API key required for non-USD.
get_fx_price(base, quote, start_date=None, end_date=None, indicators=None)

Fetches daily FX spot rates between two currencies.

  • indicators: Optional comma-separated technical indicators — "sma_20", "sma_50", "sma_200", "rsi_14", "macd", "ema_12", "ema_26", "bollinger_bands", or "all".
  • API key required.
get_calendar(currency, indicator=None)

Fetches upcoming economic data release dates for a currency.

  • indicator: Optional filter to a specific indicator slug.
  • Returns announcement_datetime (Unix timestamp) and release (indicator slug).
get_data_catalogue(currency, include_capabilities=False, include_coverage=False, indicator=None)

Discovers available macroeconomic indicators for a given currency.

  • Returns a dict keyed by indicator slug with name, unit, frequency, and has_official_forecast.
  • API key required for non-USD.
get_cot(currency, start_date=None, end_date=None)

Fetches CFTC Commitment of Traders (COT) positioning data.

  • Supported currencies: AUD, CAD, CHF, EUR, GBP, JPY, NZD, USD.
  • API key required for non-USD.
get_commodities(indicator, start_date=None, end_date=None)

Fetches commodity price time series.

  • indicator: "gold", "silver", or "platinum".
  • API key required.

💹 Supported Currencies & Indicators

18 currencies supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.

The table below shows a sample of indicator coverage across four major currencies. Use get_data_catalogue() to discover the full list for any currency.

CategoryMetricUSDEURAUDGBP
EconomyGDP Growth✓✓✓✓
Inflation Rate✓✓✓✓
Trade Balance✓✓✓✓
Current Account Balance✓✓✓✓
Retail Sales✓✓✓✓
Industrial Production✓———
Labor MarketUnemployment Rate✓✓✓✓
Employment Level✓✓✓✓
Full-Time Employment✓✓✓—
Part-Time Employment✓✓✓✓
Participation Rate✓✓✓✓
Non-Farm Payrolls✓———
Monetary PolicyPolicy Rate✓✓✓✓
Risk-Free Rate✓✓✓✓
Central Bank Assets✓—✓—
Government Bond Yields2-Year Govt Bond✓✓✓✓
5-Year Govt Bond✓✓✓✓
10-Year Govt Bond✓✓✓✓
Inflation-Linked Bond✓✓✓✓

📄 License

MIT License © FXMacroData


🌐 Links

  • Website: https://fxmacrodata.com/?utm_source=github&utm_medium=referral&utm_campaign=fxmacrodata&utm_content=readme
  • API Docs: https://fxmacrodata.com/docs?utm_source=github&utm_medium=referral&utm_campaign=fxmacrodata&utm_content=readme
  • GitHub: https://github.com/fxmacrodata/fxmacrodata
  • PyPI: https://pypi.org/project/fxmacrodata/
  • Readthedocs: https://fxmacrodata.readthedocs.io/en/latest/
  • Zenodo: https://zenodo.org/records/18280968
问 PopNx