localsbnb-mcp-server 1.0.2 → 1.0.4
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
CHANGED
|
@@ -51,7 +51,7 @@ AI 会帮您调用路客云，并返回结果。
|
|
|
51
51
|
| **APP_SECRET** | 路客云访问令牌，用于 API 鉴权 | `Bearer eyJxxx...` 或 `ut_xxx` |
|
|
52
52
|
| **APP_ID** | 营地/物业 ID，标识一家店或经营主体 | 数字字符串，如 `12345` |
|
|
53
53
|
|
|
54
|
-
请联系路客云管理员或进入路客云后台获取：https://
|
|
54
|
+
请联系路客云管理员或进入路客云后台获取：https://minsubao.localhome.cn/ → 「设置」→「API 密钥管理」或联系技术支持。
|
|
55
55
|
|
|
56
56
|
> ⚠️ **安全提醒**：请勿将凭证分享给他人或提交到公开代码仓库。
|
|
57
57
|
|
|
@@ -115,27 +115,14 @@ AI 会帮您调用路客云，并返回结果。
|
|
|
115
115
|
2. 添加与上文相同的 `mcpServers` 配置块
|
|
116
116
|
3. 保存并重启 Claude Desktop
|
|
117
117
|
|
|
118
|
-
###
|
|
119
|
-
|
|
120
|
-
默认使用**生产环境**。如需**开发环境**，在 `env` 中增加：
|
|
121
|
-
|
|
122
|
-
```json
|
|
123
|
-
"NODE_ENV": "develop"
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
| NODE_ENV | API 环境 |
|
|
127
|
-
|----------|----------|
|
|
128
|
-
| 不设置 / `production` | 生产：`hudson-prod.localhome.cn` |
|
|
129
|
-
| `develop` / `development` | 开发：`hudson-dev.localhome.cn` |
|
|
130
|
-
|
|
131
|
-
### 六、验证配置
|
|
118
|
+
### 五、验证配置
|
|
132
119
|
|
|
133
120
|
- **Cursor**：`Cmd/Ctrl + Shift + P` → 输入「MCP」，查看是否出现 `LocalsBnb MCP` 相关工具
|
|
134
121
|
- **Claude Desktop**：新开对话，输入 `@LocalsBnb MCP` 或「查询今天的房态」
|
|
135
122
|
|
|
136
123
|
若能返回房态、订单等数据，说明配置成功。
|
|
137
124
|
|
|
138
|
-
###
|
|
125
|
+
### 六、可用工具一览
|
|
139
126
|
|
|
140
127
|
| 工具名 | 说明 | 示例指令 |
|
|
141
128
|
|--------|------|----------|
|
|
@@ -146,24 +133,21 @@ AI 会帮您调用路客云，并返回结果。
|
|
|
146
133
|
| `query_room_prices` | 近期房价 | 「本周房价是多少？」 |
|
|
147
134
|
| `query_operational_data_v2` | 运营数据 | 「今天的经营情况如何？」 |
|
|
148
135
|
|
|
149
|
-
###
|
|
136
|
+
### 七、配置项速查
|
|
150
137
|
|
|
151
138
|
| 环境变量 | 必填 | 说明 |
|
|
152
139
|
|----------|------|------|
|
|
153
140
|
| `APP_SECRET` | 是 | 路客云访问令牌 |
|
|
154
141
|
| `APP_ID` | 是 | 营地 ID |
|
|
155
|
-
| `NODE_ENV` | 否 | `production` / `develop`，切换 API 环境 |
|
|
156
142
|
| `LOG_LEVEL` | 否 | `info` / `debug`，调试用 |
|
|
157
|
-
| `LUKEYUN_API_BASE_URL` | 否 | 显式指定 API 地址 |
|
|
158
143
|
|
|
159
|
-
###
|
|
144
|
+
### 八、常见问题
|
|
160
145
|
|
|
161
146
|
| 问题 | 解决 |
|
|
162
147
|
|------|------|
|
|
163
148
|
| 连接失败 / 无权限 | 确认 `APP_SECRET`、`APP_ID` 正确，且已开通 MCP/API 权限 |
|
|
164
149
|
| 找不到工具 | 检查 JSON 格式、路径是否正确，完全重启客户端 |
|
|
165
150
|
| ERR_REQUIRE_ESM | 使用 `dist/run.sh` 或 `dist/run.cjs` |
|
|
166
|
-
| 想用开发环境 | 在 `env` 中增加 `"NODE_ENV": "develop"` |
|
|
167
151
|
| npx 缓存异常（Windows） | 执行 `npx clear-npx-cache` 后重试 |
|
|
168
152
|
|
|
169
153
|
---
|
|
@@ -190,12 +174,9 @@ AI 会帮您调用路客云，并返回结果。
|
|
|
190
174
|
|
|
191
175
|
## 需要帮助？
|
|
192
176
|
|
|
193
|
-
-
|
|
194
|
-
- **用户配置详解**：`05-用户配置指南.md`
|
|
195
|
-
- **部署说明**：`README-部署说明.md`
|
|
196
|
-
- **技术支持**：support@lukeyun.com
|
|
177
|
+
- **技术支持**：https://minsubao.localhome.cn/
|
|
197
178
|
|
|
198
179
|
---
|
|
199
180
|
|
|
200
181
|
**文档版本**：v1.0
|
|
201
|
-
**最后更新**：
|
|
182
|
+
**最后更新**：2026年
|
package/dist/package.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"queryTodayRoomStatus.d.ts","sourceRoot":"","sources":["../../../src/tools/rooms/queryTodayRoomStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2FtD,eAAO,MAAM,2BAA2B,EAAE,
|
|
1
|
+
{"version":3,"file":"queryTodayRoomStatus.d.ts","sourceRoot":"","sources":["../../../src/tools/rooms/queryTodayRoomStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2FtD,eAAO,MAAM,2BAA2B,EAAE,WA0EzC,CAAC"}
|
|
@@ -12,10 +12,11 @@ export const queryTodayRoomStatusHandler = async (args, context) => {
|
|
|
12
12
|
permissionChecker.checkPermission('query_today_room_status', ['rooms:read']);
|
|
13
13
|
// 参数验证
|
|
14
14
|
const validatedParams = queryTodayRoomStatusSchema.parse(args);
|
|
15
|
-
// 如果没有提供date
|
|
16
|
-
const date = validatedParams.date || new Date().
|
|
17
|
-
//
|
|
18
|
-
|
|
15
|
+
// 如果没有提供date，使用当天日期（基于中国时区 Asia/Shanghai，确保与路客云 API 一致）
|
|
16
|
+
const date = validatedParams.date || new Date().toLocaleDateString('sv', { timeZone: 'Asia/Shanghai' });
|
|
17
|
+
// 将日期转换为时间戳：必须是一天的开始（中国时区 UTC+8 的 00:00:00）
|
|
18
|
+
// new Date('YYYY-MM-DD') 会被解析为 UTC 午夜，在中国是 08:00，不符合 API 要求
|
|
19
|
+
const dateTimestamp = new Date(`${date}T00:00:00+08:00`).getTime();
|
|
19
20
|
logger.info('Querying today room status', { date });
|
|
20
21
|
// 从context中获取campId
|
|
21
22
|
const campId = context.campId;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"queryTodayRoomStatus.js","sourceRoot":"","sources":["../../../src/tools/rooms/queryTodayRoomStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,aAAa;AACb,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAC,QAAQ,EAAE;CAC/E,CAAC,CAAC;AAmFH,MAAM,CAAC,MAAM,2BAA2B,GAAgB,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAC9E,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;QAEzD,OAAO;QACP,iBAAiB,CAAC,eAAe,CAAC,yBAAyB,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;QAE7E,OAAO;QACP,MAAM,eAAe,GAAG,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/D,
|
|
1
|
+
{"version":3,"file":"queryTodayRoomStatus.js","sourceRoot":"","sources":["../../../src/tools/rooms/queryTodayRoomStatus.ts"],"names":[],"mappings":"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"}
|