内容
Konseki MCP
Konseki 官方模型上下文协议服务器。
Konseki 是一个预计算的历史市场上下文 API，适用于全球股票，专为 AI 交易和量化分析而设计。它将当前市场条件与历史类似情况进行匹配，并返回结构化的模式匹配数据、结果分布和匹配质量评分，为 AI 代理提供基于证据而非通用评论的推理依据。
Konseki MCP 是 Kon 公共 API 的直接封装。它允许 AI 代理和 AI 交易工具通过 MCP 工具调用 Konseki 端点，同时或下游应用程序保留原始 API 响应 JSON，以便解析。
已发布软件包：[`@konseki/mcp`](https://www.npmjs.com/package/@konseki/m## 要求
- Node.js 20 或更高版本。
- Konseki API 密钥。
从 [ki.io](https://konseki.io) 获取 API 密钥。
## 设计原则
- 直接 API 封装CP 服务器获取 Konseki API 响应并在不解释。
- 用户自主解释：用户、构建者和下游 AI 客户端决定总结返回的 JSON。
- 仅限公共 API：服务器对已文档化的 Konseki 端点使用 `X-API-Key`。
- 无内部凭证：此软件包从不要求非公共服务或操作凭证。
## 配置
服务器从环境变量中读取配置：
```sh
KONSEKI_API_KEY=ks_live_your_api_key
```
请勿提交真实的 API 密钥。
## 预期架构
```text
AI 客户端
|
v
Konseki MCP 服务器
|
v
Konseki 公共 API
|
v
原始历史市场上下文 JSON
```
MCP 服务器不应绕过 Konseki 公共 API 行为。它应像其他公共 API 客户端一样表现。
## 工具
### `get_konseki_metadata`
从 `GET /v1/metadata` 获取原始 JSON。
输入：无。
### `list_konseki_symbols`
从 `GET /v1/symbols` 获取原始 JSON。
输入：无。
### `get_konseki_analysis`
从 `GET /v1/analysis/{symbol}-{exchange}?lookback={lookback}` 获取原始 JSON。
输入：
```json
{
"symbol": "AAPL",
"exchange": "NASDAQ",
"lookback": 15
}
```
支持的 `lookback` 值：`5`、` `10`、`15`、`20`、`25`、`30`、`40`、`50`。
## 响应压缩
服务器请求 gzip 压缩的 API 响应，并在返回 JSON 给 MCP 客户端之前在本地解压缩。这会自动处理；用户无需配置压缩。
## 安装
通过 `npx` 使用已发布的 npm 软件包：
```json
{
"mcpServers": {
"konseki": {
"command": "npx",
"args": ["-y", "@konseki/mcp"],
"env": {
"K_API_KEY": "ks_live_your_api_key"
}
}
}
}
```
这是推荐的配置，适用于希望从 npm 获取官方发布软件包的用户。
## 本地开发
从此检查点进行开发，安装依赖项，构建软件包，并配置 MCP 客户端以运行已构建的服务器：
```sh
npm install
npm run build
```
```json
{
"mcpServers": {
"konseki": {
"command": "node",
"args": ["/absolute/path/to/konseki-mcp/dist/index.js"],
"env": {
"KONSEKI_API_KEY": "ks_live_your_api_key"
}
}
}
}
```
## 开发
安装依赖项：
```sh
npm install
```
运行验证：
```sh
npm run typecheck
npm test
npm run build
```
## 安全
- 永远不要提交真实的 API 密钥。
- 永远不要记录原始 API 密钥。
- 永远不要在测试示例中包含用户凭证。
- 在文档和测试中使用假密钥。
