Skip to main content
Glama
Nowng

fred-mcp

by Nowng
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

FRED MCP → LM Studio Plugin (Port)

原專案: https://github.com/stefanoamorelli/fred-mcp-server
本移植版將 3 大工具完整帶入 LM Studio Plugin 系統，程式碼精簡高效 (< 300 LOC 核心)。

功能對應

原 MCP Tool

LM Studio Plugin Tool

說明

fred_browse

fred_browse

瀏覽 categories/releases/sources/category_series/release_series

fred_search

fred_search

關鍵字 / tag 搜尋 80 萬+ 指標，找 GDP, UNRATE 等 ID

fred_get_series

fred_get_series

取回時間序列觀測值，支援 units/frequency 轉換

Related MCP server: FRED Economic MCP Server

架構

fred-mcp-lmstudio/
├── manifest.json      # LM Studio 插件描述 (owner=local)
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts         # main() 註冊 config + toolsProvider
│   ├── config.ts        # globalConfig: fredApiKey, perChat: limit/sort
│   ├── fredClient.ts    # 極簡 FRED API fetch wrapper (共用)
│   └── toolsProvider.ts # 3 tools 實作，<250 行

核心設計：

  • fredClient.ts 單一 fetch 函式處理所有 FRED endpoint，自動加上 api_key & file_type=json，錯誤精簡拋出

  • config 分離：API Key 放 Global (跨對話共用)，limit/sort 放 Per-Chat

  • toolsProvider 共用 getKey() + clean() 去除空參數，避免冗長程式碼

  • 觀測值只回傳最後 200 筆 + metadata，避免 LLM token 爆炸，仍保留 count/range

安裝 (LM Studio Plugin 模式 - 推薦)

前置

自動安裝

git clone https://github.com/stefanoamorelli/fred-mcp-server fred-mcp-lmstudio
cd fred-mcp-lmstudio
# 複製本移植的檔案覆蓋 (或直接用本資料夾)
npm install
npx tsc
# 複製到 LM Studio plugins 目錄
# Windows:
# mkdir "%USERPROFILE%\.lmstudio\extensions\plugins\lmstudio\fred-mcp-lmstudio"
# Linux/macOS:
mkdir -p ~/.lmstudio/extensions/plugins/lmstudio/fred-mcp-lmstudio
cp -r manifest.json package.json dist src ~/.lmstudio/extensions/plugins/lmstudio/fred-mcp-lmstudio/

# 啟動 dev 模式
cd ~/.lmstudio/extensions/plugins/lmstudio/fred-mcp-lmstudio
lms dev

在 LM Studio 設定 API Key

  1. 開 LM Studio → 右側 Program → Plugins → fred-mcp → Settings

  2. Global Config → FRED API Key 貼上

  3. 存檔，plugin 自動重載

使用

載入任意支援 tool calling 的模型 (Qwen2.5, Llama 3.1, GPT-OSS 等)

"幫我搜尋失業率相關指標，然後取 UNRATE 最近 2 年數據"

模型會自動呼叫 fred_search → fred_get_series。

安裝 (MCP Server 相容模式 - 給 LM Studio mcp.json)

如果你不想用 Plugin，也可當成純 MCP Server 給 LM Studio 使用 (LM Studio 原生支援 MCP)。

1. 編譯獨立 MCP Server

本移植已內含 src/mcpServer.ts 精簡版 MCP Server (std io + http 可選)。

npm install @modelcontextprotocol/sdk
# 已在 src/mcpServer.ts
npx tsc

2. 編輯 LM Studio mcp.json

Program → Install → Edit mcp.json

{
  "mcpServers": {
    "fred-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/fred-mcp-lmstudio/dist/mcpServer.js"],
      "env": {
        "FRED_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

或使用 http 傳輸:

{
  "mcpServers": {
    "fred-mcp": {
      "url": "http://localhost:3000/mcp",
      "headers": {}
    }
  }
}
# 啟動: PORT=3000 TRANSPORT=http node dist/mcpServer.js

儲存後 LM Studio 會自動載入 3 tools。

範例 Prompt

  • "瀏覽 FRED 的 GDP 相關分類"

  • "搜尋 CPI 相關 series，選最熱門的 5 個"

  • "取 GDP (series_id=GDP) 2020-01-01 到現在，轉成年增率 pc1"

  • "比較 UNRATE 和 CPIAUCSL 最近一年走勢"

授權

AGPL-3.0 (跟隨原專案)。商業授權請聯絡 stefano@amorelli.tech

免責

非聯準會官方，FRED 為 St. Louis Fed 註冊商標。

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • FRED Macroeconomic Data MCP

    hungson175
    F
    license
    -
    quality
    D
    maintenance
    Provides access to Federal Reserve Economic Data (FRED) through Claude and other LLM clients, enabling users to search for, retrieve, and visualize economic indicators like GDP, employment, and inflation data.
    Last updated
    8

  • FRED Economic MCP Server

    satendra-mani-tiwari
    A
    license
    -
    quality
    D
    maintenance
    Provides access to 800,000+ Federal Reserve Economic Data (FRED) time series, enabling users to search, retrieve, and analyze economic indicators like GDP, unemployment, inflation, and interest rates through natural language queries.
    Last updated
    MIT

  • mcp-fred

    PetrefiedThunder
    F
    license
    -
    quality
    D
    maintenance
    An MCP server that wraps the Federal Reserve Economic Data (FRED) API, providing access to over 800,000 economic time series like GDP and unemployment. It enables AI agents to search for data, retrieve metadata, and fetch historical observations directly from the St. Louis Fed.
    Last updated

View all related MCP servers

Related MCP Connectors

  • World Bank & FRED Macro

    Macro indicators from World Bank, FRED, IMF, and OECD via unified query surface.

  • Economy Intel MCP

    Macro data for AI agents: GDP, inflation, unemployment and more (World Bank, US BLS). No keys.

  • bls-labor-mcp-server

    Fetch US Bureau of Labor Statistics data — CPI, unemployment, wages, JOLTS, and more via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Nowng/fred-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server