mcp-algorithm-box-config 1.0.0 → 1.0.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/README.md +127 -0
- package/dist/index.js +1 -1
- package/package.json +3 -2
package/README.md
ADDED
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
# mcp-algorithm-box-config
|
|
2
|
+
|
|
3
|
+
MCP Server — 算法盒子轮询配置方案统计图生成器。
|
|
4
|
+
|
|
5
|
+
根据摄像头总数、轮询间隔和最大等待时间，用 **FIFO连续模型** 计算每个「等待时间 × 实时分析数」组合下的最少盒子数，生成**自包含 HTML 交互式图表**（ECharts 热力图 + 最优方案表），无需后端服务。
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 快速开始
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npx -y mcp-algorithm-box-config
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## MCP 客户端配置
|
|
16
|
+
|
|
17
|
+
### Claude Desktop
|
|
18
|
+
|
|
19
|
+
编辑 `%APPDATA%\Claude\claude_desktop_config.json`：
|
|
20
|
+
|
|
21
|
+
```json
|
|
22
|
+
{
|
|
23
|
+
"mcpServers": {
|
|
24
|
+
"box-config": {
|
|
25
|
+
"command": "npx",
|
|
26
|
+
"args": ["-y", "mcp-algorithm-box-config"]
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### VS Code / Cursor
|
|
33
|
+
|
|
34
|
+
在 `.vscode/mcp.json` 或对应 MCP 配置中：
|
|
35
|
+
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"servers": {
|
|
39
|
+
"box-config": {
|
|
40
|
+
"command": "npx",
|
|
41
|
+
"args": ["-y", "mcp-algorithm-box-config"]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
配置后重启客户端即可使用。
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 工具
|
|
52
|
+
|
|
53
|
+
### `generate_box_config_chart`
|
|
54
|
+
|
|
55
|
+
生成盒子配置方案统计图。
|
|
56
|
+
|
|
57
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
58
|
+
|:---|:---|:---|:---|
|
|
59
|
+
| `totalCameras` | number | 1619 | 摄像头总数 |
|
|
60
|
+
| `pollIntervalMin` | number | 3 | 轮询间隔（分钟） |
|
|
61
|
+
| `maxWaitTimeMin` | number | 60 | 最大等待时间（分钟） |
|
|
62
|
+
|
|
63
|
+
**返回**
|
|
64
|
+
|
|
65
|
+
1. 📁 生成的 HTML 文件路径（`file:///...`）
|
|
66
|
+
2. 📊 数据摘要：全局最少盒子数、推荐实时分析数、每盒摄像头数等
|
|
67
|
+
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## 使用示例
|
|
71
|
+
|
|
72
|
+
对 AI 说：
|
|
73
|
+
|
|
74
|
+
```
|
|
75
|
+
生成1619个摄像头、3分钟轮询、最大等待30分钟的盒子配置图
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
```
|
|
79
|
+
生成2000个摄像头、5分钟轮询、最大等待45分钟的盒子配置统计图
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
AI 会调用 MCP 工具，返回一个 HTML 文件路径。在浏览器中打开即可看到：
|
|
83
|
+
|
|
84
|
+
- **热力图**：X轴=等待时间，Y轴=每盒实时分析数，色块=盒子数（绿少红多），蓝色边框标出每列最优
|
|
85
|
+
- **组合图**：柱状=最少盒子数，折线=最优实时分析数 & 每盒摄像头数
|
|
86
|
+
- **明细表**：每个等待时间档位的最优配置，全局最优高亮
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 计算模型（FIFO连续）
|
|
91
|
+
|
|
92
|
+
| 参数 | 值 |
|
|
93
|
+
|:---|:---|
|
|
94
|
+
| 每盒最大摄像头 | 256 |
|
|
95
|
+
| 每盒最大同时分析 | 32 |
|
|
96
|
+
|
|
97
|
+
- **实时分析**：摄像头持续分析，不参与轮询
|
|
98
|
+
- **轮询分析**：采用 FIFO（先入先出）策略，每次优先分析等待时间最长的摄像头
|
|
99
|
+
- **无需向上取整**：FIFO 模型是连续流式的，不存在"最后一组凑不满"的问题
|
|
100
|
+
|
|
101
|
+
约束公式：`轮询摄像头数 / (32 - 实时分析数) × 轮询间隔 ≤ 目标等待时间`
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## HTML 输出
|
|
106
|
+
|
|
107
|
+
生成的 HTML 完全自包含：
|
|
108
|
+
- ECharts 从 CDN 加载（首次需联网）
|
|
109
|
+
- 计算逻辑和数据内嵌在页面中
|
|
110
|
+
- 无后端依赖，无需认证
|
|
111
|
+
- 可直接分享给他人查看
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 开发
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
git clone <repo-url>
|
|
119
|
+
cd mcp-box-config
|
|
120
|
+
npm install
|
|
121
|
+
npm run dev # 开发模式（热重载）
|
|
122
|
+
npm run build # 编译 TypeScript
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
## License
|
|
126
|
+
|
|
127
|
+
MIT
|
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mcp-algorithm-box-config",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "MCP Server — 算法盒子轮询配置方案统计图生成器（自包含HTML，无需后端）",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -8,7 +8,8 @@
|
|
|
8
8
|
"mcp-algorithm-box-config": "dist/index.js"
|
|
9
9
|
},
|
|
10
10
|
"files": [
|
|
11
|
-
"dist/"
|
|
11
|
+
"dist/",
|
|
12
|
+
"README.md"
|
|
12
13
|
],
|
|
13
14
|
"scripts": {
|
|
14
15
|
"start": "npx tsx src/index.ts",
|