内容
# Haver MCP 服务器
一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，为 Claude（或任何与 MCP 兼容的 LLM 客户端）提供结构化、令牌高效的访问 [Haver Analytics](https://www.haver.com/) ——涵盖 Haver 的所有 138 个美国和国际数据库。
它公开了六种用于系列发现和数据检索的工具：
| 工具 | 用途 |
|------|---------|
| `haver_search` | 跨数据库的关键词搜索（例如 `"TTF 天然气"`） |
| `haver_search_by_code` | 使用 SQL 通配符进行模式搜索（例如 `"R134G%"` 表示德国收益率） |
| `haver_browse` | 按字母顺序浏览数据库 |
| `haver_list_databases` | 列出 138 个数据库，可选地按关键词过滤 |
| `haver_series_info` | 在提取数据之前获取特定系列的完整元数据 |
| `haver_get_data` | 获取时间序列数据，可选日期过滤 |
## 前置条件
- 有效的 **Haver Analytics** 订阅和 API 密钥。请联系您的 Haver 账户代表获取访问权限。
- 在您的机器上安装 [`uv`](https://docs.astral.sh/uv/)。一行命令：
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
您 **不需要** 克隆此仓库或管理虚拟环境——`uvx` 从 git URL 处理一切。
## 安装
### Claude 代码
将以下内容添加到您的 `.mcp.json`（项目级或工作区级）：
```json
{
"mcpServers": {
"haver": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/joshua-bailey/haver-mcp-server.git",
"haver-mcp-server"
],
"env": {
"HAVER_API_KEY": "您的 Haver API 密钥"
}
}
}
}
```
然后重启 Claude 代码。这六种 `haver_*` 工具应该会出现。
### Claude 桌面版
相同的 JSON 代码段，放在以下位置的 `mcpServers` 下：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
### 锁定版本
`uvx` 默认安装 `main` 分支上的最新提交。要锁定到标记版本，请在 git URL 中追加 `@<tag>`，例如：
```
"git+https://github.com/joshua-bailey/haver-mcp-server.git@v0.5.0"
```
## 环境变量
| 变量 | 是否必需？ | 用途 |
|----------|-----------|---------|
| `HAVER_API_KEY` | **是** | 您的 Haver Analytics API 密钥。 |
## 使用它
一旦注册了 MCP，请询问 Claude 类似的问题：
- "在 Haver 中搜索 TTF 天然气系列"
- "显示 INTDAILY 中所有德国收益率系列，代码以 `R134G` 开头"
- "提取 2020 年以来的 GDP@USECON 和 PCE@USECON"
- "列出 Haver 数据库中包含 'commodity' 的数据库"
Claude 将选择正确的工具并调用它。
## 致谢和上游依赖
该服务器是围绕 [**`haver-api`**](https://github.com/LucaMingarelli/haver) 的薄 MCP 包装器，由 **Luca Mingarelli** 开发，该包装器处理与 Haver Analytics REST API 的身份验证和数据检索。请在使用此服务器时单独确认该软件包：
- 源代码：https://github.com/LucaMingarelli/haver
- PyPI：https://pypi.org/project/haver-api/
- 许可证：**CC BY-NC-SA 4.0** （署名-非商业-分享 4.0 国际）。在使用前请查看上游许可证——`haver-api` 的条款独立于此包装器的 MIT 许可证。
`haver-api` 作为正常依赖项从 PyPI 安装，当您运行 `uvx` 时；我们不会在此处重新分发其源代码。
## 许可证
MIT——请参阅 [LICENSE](LICENSE)。仅适用于此仓库中的包装器代码。依赖项保留其自己的许可证。
