README.md
原專案: 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 轉換 |
核心設計：
README.md
原專案: 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 轉換 |
核心設計：
api_key & file_type=json，錯誤精簡拋出getKey() + clean() 去除空參數，避免冗長程式碼lms CLI 已在 PATH (LM Studio 附帶)載入任意支援 tool calling 的模型 (Qwen2.5, Llama 3.1, GPT-OSS 等)
"幫我搜尋失業率相關指標，然後取 UNRATE 最近 2 年數據"
模型會自動呼叫 fred_search → fred_get_series。
如果你不想用 Plugin，也可當成純 MCP Server 給 LM Studio 使用 (LM Studio 原生支援 MCP)。
本移植已內含 src/mcpServer.ts 精簡版 MCP Server (std io + http 可選)。
Program → Install → Edit mcp.json
或使用 http 傳輸:
儲存後 LM Studio 會自動載入 3 tools。
AGPL-3.0 (跟隨原專案)。商業授權請聯絡 stefano@amorelli.tech
非聯準會官方，FRED 為 St. Louis Fed 註冊商標。
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 行
api_key & file_type=json，錯誤精簡拋出getKey() + clean() 去除空參數，避免冗長程式碼lms CLI 已在 PATH (LM Studio 附帶)載入任意支援 tool calling 的模型 (Qwen2.5, Llama 3.1, GPT-OSS 等)
"幫我搜尋失業率相關指標，然後取 UNRATE 最近 2 年數據"
模型會自動呼叫 fred_search → fred_get_series。
如果你不想用 Plugin，也可當成純 MCP Server 給 LM Studio 使用 (LM Studio 原生支援 MCP)。
本移植已內含 src/mcpServer.ts 精簡版 MCP Server (std io + http 可選)。
Program → Install → Edit mcp.json
或使用 http 傳輸:
儲存後 LM Studio 會自動載入 3 tools。
AGPL-3.0 (跟隨原專案)。商業授權請聯絡 stefano@amorelli.tech
非聯準會官方，FRED 為 St. Louis Fed 註冊商標。
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 行
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
npm install @modelcontextprotocol/sdk
# 已在 src/mcpServer.ts
npx tsc
{
"mcpServers": {
"fred-mcp": {
"command": "node",
"args": ["/absolute/path/to/fred-mcp-lmstudio/dist/mcpServer.js"],
"env": {
"FRED_API_KEY": "YOUR_KEY_HERE"
}
}
}
}
{
"mcpServers": {
"fred-mcp": {
"url": "http://localhost:3000/mcp",
"headers": {}
}
}
}
# 啟動: PORT=3000 TRANSPORT=http node dist/mcpServer.js
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
npm install @modelcontextprotocol/sdk
# 已在 src/mcpServer.ts
npx tsc
{
"mcpServers": {
"fred-mcp": {
"command": "node",
"args": ["/absolute/path/to/fred-mcp-lmstudio/dist/mcpServer.js"],
"env": {
"FRED_API_KEY": "YOUR_KEY_HERE"
}
}
}
}
{
"mcpServers": {
"fred-mcp": {
"url": "http://localhost:3000/mcp",
"headers": {}
}
}
}
# 啟動: PORT=3000 TRANSPORT=http node dist/mcpServer.js