纽约联储MCP服务器
用于访问纽约联邦储备银行市场数据API的模型上下文协议（MCP）服务器。该服务器提供对金融市场数据的标准化访问，包括参考利率、SOMA持有量、财政部运营等。
特性
此MCP服务器提供对以下纽约联邦储备银行数据的访问：
📊 参考价格
- 所有参考价格：SOFR、EFFR、OBFR、TGCR、BGCR在一个请求中
- 固定利率：SOFR（担保隔夜融资利率）、TGCR、BGCR
- 无担保利率：EFFR（有效联邦基金利率），OBFR
🏦 系统公开市场账户（SOMA）控股
- 持有的国债（票据、票据/债券、FRN、TIPS）
- 机构证券持有（机构债务、MBS、CMBS）
- 按日期、CUSIP或持有类型分类的持有情况
- 汇总数据和历史信息
💼 市场运作
- 财务运营：购买、销售和支付的价格
- 回购运营：回购和反向回购操作
- 主要经销商统计：调查数据和市场份额信息
📈 数据格式
所有端点都支持多种格式：
- JSON（默认）
- 可扩展置标语言
- CSV文件
- 可移植文档格式
- Excel（XLSX）
安装
选项1：通过NPM/NPX（推荐）
使用此服务器的最简单方法是通过npx：
npx @trygordian/mcp-newyorkfed选项2：来源
- 克隆此存储库：
git clone https://github.com/trygordian/mcp-newyorkfed.git
cd mcp-newyorkfed- 安装依赖项：
npm install- 构建项目：
npm run build用法
作为MCP服务器
服务器实现了模型上下文协议，可以与任何兼容MCP的客户端一起使用。
MCP客户端的配置：
使用NPX（推荐）：
{
"mcpServers": {
"newyorkfed": {
"command": "npx",
"args": [
"-y",
"@trygordian/mcp-newyorkfed"
]
}
}
}使用本地安装：
{
"mcpServers": {
"newyorkfed": {
"command": "node",
"args": ["path/to/mcp-newyorkfed/build/index.js"]
}
}
}直接运行服务器：
# Via NPX
npx @trygordian/mcp-newyorkfed
# Via NPM (if installed globally)
npm install -g @trygordian/mcp-newyorkfed
mcp-newyorkfed
# From source
npm start
# or
node build/index.js可用工具
1. get_reference_rates_all
获取最新日期的所有参考价格或使用筛选器进行搜索。
参数：
operation：“最新”|“搜索”format：“json”|“xml”|“csv”|“pdf”|“xlsx”startDate：搜索开始日期（YYYY-MM-DD）endDate：搜索结束日期（YYYY-MM-DD）
例子：
{
"operation": "latest",
"format": "json"
}2. get_secured_rates
获得安全的参考利率（SOFR、TGCR、BGCR）。
参数：
operation：“最新”|“最后”|“搜索”rateType：“sofr”|“tgcr”|“bgcr”（最后一次/搜索时需要）number：记录数（1-1000，表示“最后一次”操作）format：响应格式startDate/endDate：搜索日期范围
例子：
{
"operation": "last",
"rateType": "sofr",
"number": 30,
"format": "json"
}3. get_unsecured_rates
获取无担保参考利率（EFFR、OBFR）。
参数：
operation：“最新”|“最后”|“搜索”rateType：“effr”|“obfr”（最后一次/搜索需要）number：记录数（1-1000，表示“最后一次”操作）format：响应格式startDate/endDate：搜索日期范围
4. get_soma_holdings
获取系统公开市场账户持有数据。
参数：
operation：“摘要”|“最新日期”|“列表日期”|《财富》\_by_date |“机构_by_date”|“《财富》-by_cusip”|“机构-by_cusif”format：响应格式date：截至日期（YYYY-MM-DD，\*\_by_date操作需要）cusip：CUSIP标识符（\*\_by_CUSIP操作所需）holdingType：“账单”|“票据”|“frn”|“提示”|“代理债务”|“mbs”|“cmbs”
例子：
{
"operation": "treasury_by_date",
"date": "2024-01-15",
"holdingType": "bills",
"format": "json"
}5. get_treasury_operations
获得国债业务。
参数：
operation：“购买”|“销售”timeframe：“最新”|“最近两周”|“最后”status：“全部”|“已完成”（最新要求）include：“详细信息”|“摘要”number：操作次数（针对“最后”时间段）format：响应格式startDate/endDate：日期范围
6. get_repo_operations
获取回购和反向回购操作。
参数：
operationType：“repo”|“reverserepo”method：“全部”|“单部分”|“多价格”timeframe：“最新”|“最近两周”|“最后”|“搜索”status：“全部”|“已完成”（最新要求）number：操作次数（针对“最后”时间段）format：响应格式startDate/endDate：搜索日期范围
7. get_primary_dealer_statistics
获取主要经销商统计调查数据。
参数：
operation：“latest_by_series”|“all_surveys”|“list_timeseries”|“list_dates”|“list_series \_breaks”|“by_date”|“by time series”seriesBreak：系列中断标识符date：截至日期（YYYY-MM-DD）timeseries：时间序列/密钥IDformat：响应格式
8. get_market_share
获取主要经销商市场份额数据。
参数：
period：“季度”|“ytd”format：响应格式
API数据源
此服务器提供对纽约联邦储备银行市场数据API数据的访问：
- 基本URL:
https://markets.newyorkfed.org - 文档： 纽约联储市场API文件
法律声明
参考利率、市场数据API和通过市场数据API访问的所有数据的使用均受 使用条款 纽约联邦储备银行网站。
参考费率受使用条款中所述的重要免责声明、条件、限制和赔偿义务的约束。
错误处理
服务器提供全面的错误处理：
- 无效参数返回详细的错误消息
- API故障包括HTTP状态代码和错误描述
- 缺失的必需参数已明确标识
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
支持
关于以下问题：
- 此MCP服务器：在此存储库中打开一个问题
- 纽约联储API数据：联系纽约联邦储备银行
- MCP协议：参见 模型上下文协议文档
______________________________________________________________________
免责声明：这是一个非正式的实施。纽约联邦储备银行不对该服务器或其功能负责。