Marketstack MCP 服务器

模型上下文协议 (MCP) 服务器将各种 Marketstack API 端点公开为 MCP 工具，提供对金融数据的访问，包括日终数据、盘中数据、拆股数据、股息数据、股票代码、交易所数据、货币数据、时区数据、债券数据和 ETF 数据。该服务器简化了将 Marketstack 数据集成到兼容 MCP 的代理和系统中的过程。

先决条件

Node.js（建议使用 v18 或更高版本）
npm（Node.js 附带）
Marketstack API 密钥
（可选）兼容 MCP 的客户端或运行器（例如 VSCode 扩展、CLI）

Related MCP server: CoinMarketCap MCP

设置

克隆存储库或确保您位于项目目录中。
安装依赖项：
npm install
配置：
- 从https://marketstack.com/获取 Marketstack API 密钥。
- 通过 MCP 运行器的设置配置MARKETSTACK_API_KEY环境变量。这是与 MCP 客户端无缝集成的推荐方法。通过 MCP 运行器运行时，请避免为此目的使用.env文件。

构建和运行

构建服务器：
npm run build
这将创建一个包含已编译 JavaScript 代码的build目录。
运行服务器：
npm run start
或直接：
node build/index.js
**通过 MCP 运行器：**配置您的 MCP 客户端，使用 stdio 传输运行服务器。MCP 设置条目示例（将/path/to/mcp-marketstack调整为您的实际路径，并将YOUR_API_KEY_HERE替换为您的实际密钥）：
"marketstack": { "transportType": "stdio", "command": "node", "args": [ "/path/to/mcp-marketstack/build/index.js" ], "env": { "MARKETSTACK_API_KEY": "YOUR_API_KEY_HERE" } // ... other optional settings ... }

可用工具

服务器将 Marketstack API 端点公开为不同的 MCP 工具，按功能分类：

市场数据
参考数据
金融工具

通过自省连接到服务器的 MCP 代理可以自动发现每个工具的详细输入模式和描述。

项目结构

该项目采用模块化结构：

. ├── src/ │ ├── index.ts # Server entry point │ ├── marketstackClient.ts # Centralized API client with caching │ ├── cacheConfig.ts # Cache TTL configurations │ └── tools/ │ ├── index.ts # Registers all tool categories │ ├── marketData/ # Market Data tools │ │ └── ... │ ├── referenceData/ # Reference Data tools │ │ └── ... │ ├── financialInstruments/ # Financial Instruments tools │ │ └── ... │ └── wrapToolHandler.ts # Wrapper for tool handlers ├── memory-bank/ # Project documentation │ └── ... ├── package.json # Project dependencies and scripts ├── tsconfig.json # TypeScript configuration ├── eslint.config.js # ESLint configuration ├── .prettierrc # Prettier configuration ├── LICENSE # Project license └── README.md # This file