@洞察哨兵/mcp
用于InsightSentry财务数据API的MCP服务器和CLI。
安装
npm install -g @insightsentry/mcp命令：
| 命令 | 目的 |
|---|---|
insight | 用于终端使用和脚本的CLI |
insight-mcp | 用于AI客户端的MCP服务器 |
mcp | 别名为 insight-mcp |
认证
为当前外壳设置API密钥：
export INSIGHTSENTRY_API_KEY="your-api-key"或者在本地为CLI保存一个：
insight login --key "your-api-key"
insight whoami
insight logoutwhoami 在本地解析配置的JWT并打印 uuid，回落到 email 然后 sub.
MCP设置
使用 npx 在MCP配置中：
{
"mcpServers": {
"insightsentry": {
"command": "npx",
"args": ["-y", "@insightsentry/mcp"],
"env": {
"INSIGHTSENTRY_API_KEY": "your-api-key"
}
}
}
}MCP服务器也会回退到由保存的密钥 insight login 当 INSIGHTSENTRY_API_KEY 未设置。 集 INSIGHTSENTRY_CONFIG_DIR 强制CLI和MCP服务器在使用不同的主目录运行时读取相同的已保存登录目录。
CLI使用情况
insight --help
insight --help
insight [--param value]示例：
insight whoami
insight search_symbols --query "tesla"
insight get_quotes --codes "NASDAQ:AAPL,NASDAQ:MSFT"
insight get_symbol_series --symbol "NASDAQ:AAPL" --bar_type day --dp 30
insight screen_stocks --fields "close,volume,market_cap" --exchanges "NYSE,NASDAQ" --sortBy market_cap --sortOrder desc
insight download_history --symbol "NASDAQ:AAPL" --bar_type day --from 2024-01-01 --to 2024-06-30 --output_dir ./history符号代码必须使用 EXCHANGE:SYMBOL 格式。使用 search_symbols 在调用符号工具之前。
所有API工具支持：
--filter ''
--store json --output_file ./response.json
--store json --output_dir ./responsesget_symbol_series 还支持CSV存储：
insight get_symbol_series --symbol "NASDAQ:AAPL" --bar_type day --store csv --output_file ./aapl.csv工具
身份验证和文件：
| 工具 | 目的 |
|---|---|
whoami | 打印配置的用户 uuid/API密钥JWT发送的电子邮件 |
download_history | 将日期范围下载到JSON/CSV文件 |
render_chart | 将Chart.js配置渲染为PNG图像 |
市场数据：
| 工具 | 目的 |
|---|---|
search_symbols | 查找有效 EXCHANGE:SYMBOL 代码 |
get_quotes | 实时报价 |
get_symbol_series | 最新OHLCV系列 |
get_symbol_history | 深厚的日内历史 |
get_symbol_info | 符号元数据 |
get_symbol_session | 交易时间和交易时段详情 |
get_symbol_contracts | 期货合约列表 |
基础知识、选项、筛选器、日历、文档：
| 工具 | 目的 |
|---|---|
get_symbol_fundamentals | 公司基本面 |
get_fundamentals_series | 历史基本指标 |
get_fundamentals_meta | 可用的基础/技术ID |
list_options | 可用期权合约 |
get_options_expiration | 期权链到期 |
get_options_strike | 罢工期权链 |
screen_stocks, screen_etfs, screen_bonds, screen_crypto | 屏幕资源 |
get_stock_screener_params, get_etf_screener_params, get_bond_screener_params, get_crypto_screener_params | 筛选器字段 |
get_dividends, get_earnings, get_ipos, get_events | 日历 |
get_newsfeed | 财经新闻 |
get_documents, get_document | 文件和成绩单 |