@apocdata-info/mcp-server 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1 -1
- package/README.md +8 -8
- package/dist/index.js +2 -2
- package/dist/resources.js +1 -1
- package/package.json +3 -2
- package/scripts/contract-test.mjs +1 -1
- package/scripts/coverage-test.mjs +1 -1
- package/scripts/error-path-test.mjs +1 -1
- package/scripts/freshness-probe.mjs +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
All notable changes to `@apocdata/mcp-server` are documented here.
|
|
3
|
+
All notable changes to `@apocdata-info/mcp-server` are documented here.
|
|
4
4
|
|
|
5
5
|
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
6
|
|
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# @apocdata/mcp-server
|
|
1
|
+
# @apocdata-info/mcp-server
|
|
2
2
|
|
|
3
3
|
天启至数 **ApocData** 的 MCP(Model Context Protocol)Server。把 46 个免鉴权 A 股数据接口包装成 MCP tools,可在 Claude Desktop / Cursor / Cline / Continue 等任意 MCP client 中直接调用。
|
|
4
4
|
|
|
5
|
-
- 数据源:`https://
|
|
5
|
+
- 数据源:`https://www.apocdata.com/api/blade-dataplatform/open/data/*`
|
|
6
6
|
- 无需 API Key,无需注册(网关已配置 `/open/**` 免鉴权)
|
|
7
7
|
- 自动透传 `X-Tdc-*` 元信息头(限流剩余/截断标志/错误码/缓存策略)
|
|
8
8
|
- 46 工具覆盖:行情、估值、财务、股东、资金流、涨跌停、板块、公告、宏观、因子、综合画像
|
|
@@ -13,12 +13,12 @@
|
|
|
13
13
|
|
|
14
14
|
### 方式 A:npx(推荐,零安装)
|
|
15
15
|
|
|
16
|
-
直接在 client 配置里写 `npx -y @apocdata/mcp-server`,无需手动 install。
|
|
16
|
+
直接在 client 配置里写 `npx -y @apocdata-info/mcp-server`,无需手动 install。
|
|
17
17
|
|
|
18
18
|
### 方式 B:全局安装
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
npm install -g @apocdata/mcp-server
|
|
21
|
+
npm install -g @apocdata-info/mcp-server
|
|
22
22
|
apocdata-mcp # 可执行命令
|
|
23
23
|
```
|
|
24
24
|
|
|
@@ -35,7 +35,7 @@ apocdata-mcp # 可执行命令
|
|
|
35
35
|
"mcpServers": {
|
|
36
36
|
"apocdata": {
|
|
37
37
|
"command": "npx",
|
|
38
|
-
"args": ["-y", "@apocdata/mcp-server"]
|
|
38
|
+
"args": ["-y", "@apocdata-info/mcp-server"]
|
|
39
39
|
}
|
|
40
40
|
}
|
|
41
41
|
}
|
|
@@ -50,7 +50,7 @@ apocdata-mcp # 可执行命令
|
|
|
50
50
|
"mcpServers": {
|
|
51
51
|
"apocdata": {
|
|
52
52
|
"command": "npx",
|
|
53
|
-
"args": ["-y", "@apocdata/mcp-server"]
|
|
53
|
+
"args": ["-y", "@apocdata-info/mcp-server"]
|
|
54
54
|
}
|
|
55
55
|
}
|
|
56
56
|
}
|
|
@@ -58,7 +58,7 @@ apocdata-mcp # 可执行命令
|
|
|
58
58
|
|
|
59
59
|
### Cline / Continue / 其它 stdio MCP client
|
|
60
60
|
|
|
61
|
-
同上,传 `command=npx, args=["-y","@apocdata/mcp-server"]` 即可。
|
|
61
|
+
同上,传 `command=npx, args=["-y","@apocdata-info/mcp-server"]` 即可。
|
|
62
62
|
|
|
63
63
|
### CLI flags
|
|
64
64
|
|
|
@@ -80,7 +80,7 @@ apocdata-mcp --help # 显示完整用法
|
|
|
80
80
|
"mcpServers": {
|
|
81
81
|
"apocdata": {
|
|
82
82
|
"command": "npx",
|
|
83
|
-
"args": ["-y", "@apocdata/mcp-server"],
|
|
83
|
+
"args": ["-y", "@apocdata-info/mcp-server"],
|
|
84
84
|
"env": { "APOCDATA_DEBUG": "1" }
|
|
85
85
|
}
|
|
86
86
|
}
|
package/dist/index.js
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
* apocdata-mcp --help | -h 打印用法后退出
|
|
11
11
|
*
|
|
12
12
|
* 环境变量:
|
|
13
|
-
* APOCDATA_BASE_URL 覆盖默认 base URL(默认指向
|
|
13
|
+
* APOCDATA_BASE_URL 覆盖默认 base URL(默认指向 www.apocdata.com)
|
|
14
14
|
* APOCDATA_DEBUG 设为 "1" 时把每次调用元信息打到 stderr
|
|
15
15
|
* APOCDATA_TIMEOUT_MS 单次请求超时(默认 30000)
|
|
16
16
|
* APOCDATA_MAX_RETRIES 5xx/网络错误重试次数(默认 2)
|
|
@@ -28,7 +28,7 @@ import { ApocDataClient, NetworkError } from './client.js';
|
|
|
28
28
|
import { ALL_RESOURCES } from './resources.js';
|
|
29
29
|
import { ALL_TOOLS } from './tools.js';
|
|
30
30
|
const PKG_VERSION = readPackageVersion();
|
|
31
|
-
const DEFAULT_BASE_URL = 'https://
|
|
31
|
+
const DEFAULT_BASE_URL = 'https://www.apocdata.com/api/blade-dataplatform/open/data';
|
|
32
32
|
const SHUTDOWN_GRACE_MS = 5_000;
|
|
33
33
|
// === CLI 处理(必须在创建 transport 之前,否则会污染 stdout) ===
|
|
34
34
|
handleCliFlags(process.argv.slice(2));
|
package/dist/resources.js
CHANGED
|
@@ -11,7 +11,7 @@ const GUIDE = `# ApocData MCP - 接入与工具速查
|
|
|
11
11
|
|
|
12
12
|
## 是什么
|
|
13
13
|
|
|
14
|
-
天启至数 ApocData 是 A 股免鉴权数据 API(\`https://
|
|
14
|
+
天启至数 ApocData 是 A 股免鉴权数据 API(\`https://www.apocdata.com/api/blade-dataplatform/open/data/*\`),本 MCP server 把 46 个端点包装成可直接调用的工具。
|
|
15
15
|
|
|
16
16
|
## 工具分组(46 个)
|
|
17
17
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@apocdata-info/mcp-server",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
|
+
"mcpName": "io.github.apocdata/mcp-server",
|
|
4
5
|
"description": "天启至数 ApocData - MCP Server for A-share market data (46 free, no-auth endpoints)",
|
|
5
6
|
"license": "Apache-2.0",
|
|
6
7
|
"type": "module",
|
|
@@ -60,7 +61,7 @@
|
|
|
60
61
|
"url": "git+https://github.com/ApocData/ApocData-skill.git",
|
|
61
62
|
"directory": "mcp-server"
|
|
62
63
|
},
|
|
63
|
-
"homepage": "https://
|
|
64
|
+
"homepage": "https://www.apocdata.com",
|
|
64
65
|
"bugs": {
|
|
65
66
|
"url": "https://github.com/ApocData/ApocData-skill/issues"
|
|
66
67
|
}
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
import { ALL_TOOLS } from '../dist/tools.js';
|
|
12
12
|
|
|
13
13
|
const BASE = process.env.APOCDATA_BASE_URL
|
|
14
|
-
?? 'https://
|
|
14
|
+
?? 'https://www.apocdata.com/api/blade-dataplatform/open/data';
|
|
15
15
|
|
|
16
16
|
// 每个 tool 的测试入参。stable A 股:000001 平安银行 / 600519 茅台
|
|
17
17
|
const TEST_INPUTS = {
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
*/
|
|
10
10
|
|
|
11
11
|
const BASE = process.env.APOCDATA_BASE_URL
|
|
12
|
-
?? 'https://
|
|
12
|
+
?? 'https://www.apocdata.com/api/blade-dataplatform/open/data';
|
|
13
13
|
|
|
14
14
|
const checks = [];
|
|
15
15
|
function check(kind, name, cond, detail = '') {
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
import { ALL_TOOLS } from '../dist/tools.js';
|
|
12
12
|
|
|
13
13
|
const BASE = process.env.APOCDATA_BASE_URL
|
|
14
|
-
?? 'https://
|
|
14
|
+
?? 'https://www.apocdata.com/api/blade-dataplatform/open/data';
|
|
15
15
|
|
|
16
16
|
const TEST_INPUTS = {
|
|
17
17
|
quote: { symbol: '000001' },
|