asset-mcp 0.2.1 → 0.2.2

package/README.md

@@ -1,94 +1,44 @@
 # asset-mcp
 
-给 Cursor 使用的 MCP Server（OAuth 标准流程骨架，零依赖版本）。
+在 Cursor 等支持 MCP 的 IDE 中连接资产管理平台（OAuth2 设备码登录，无额外依赖）。
 
 ## 功能
 
-- 暴露认证工具：`mcp_auth`（`methods/start/poll/status/logout`，仅 OAuth2 设备码）
-- 暴露身份工具：`auth.me`
-- 暴露查询工具：`assets.search`
-- 暴露业务工具：`assets.create`
-- 写操作权限由后端统一拦截（scope + RBAC + 资源级权限）
+- `mcp_auth`：`methods` / `start` / `poll` / `status` / `logout`（OAuth2 设备码）
+- `auth.me`：当前用户
+- `assets.search`：查询资产
+- `assets.create`：创建资产（权限由后端拦截）
 
-## 运行
+## 使用
 
 ```bash
-cd asset-mcp
-npm start
+npx -y asset-mcp@latest
 ```
 
-## 作为 npm 包使用
-
-```bash
-npx -y asset-mcp
-```
-
-## 发布到 npm
-
-```bash
-npm login
-npm publish --access public
-```
-
-> 如果包名已被占用，请先修改 `package.json` 里的 `name`（例如加组织作用域）。
-
-## 在 Cursor 中配置（示例）
-
-将 MCP 命令配置为：
-
-```bash
-npx -y asset-mcp
-```
+在 Cursor 的 MCP 配置里将启动命令设为上述命令，并配置下方环境变量。
 
 ## 环境变量
 
 ```bash
 export ASSET_MCP_BASE_URL="http://localhost:8080"
-export ASSET_MCP_CLIENT_ID="asset-mcp"
-export ASSET_MCP_SCOPES="assets.read assets.write"
 ```
 
-可选项：
-
-- `ASSET_MCP_DEVICE_CODE_PATH`（默认 `/oauth/device/code`）
-- `ASSET_MCP_TOKEN_PATH`（默认 `/oauth/token`）
-- `ASSET_MCP_REVOKE_PATH`（默认 `/oauth/revoke`）
-
-## 标准授权流程（Device Code）
-
-1. 先调用 `mcp_auth`，参数：`{ "action": "start" }`
-2. 按返回的 `verificationUri + userCode` 去浏览器授权
-3. 再调用 `mcp_auth`，参数：`{ "action": "poll" }`
-4. 成功后用 `auth.me` 验证登录身份
-5. 然后可调用 `assets.create`
-
-可选先调 `mcp_auth`：`{ "action": "methods" }` 查看步骤说明。
-
-说明：登录**仅**走 OAuth2 设备码；用户在浏览器授权页输入账号密码，**不要**通过 MCP 传密码。
-
-## 工具入参（assets.search）
-
-- `assetType`: `"rule" | "skill" | "mcp" | "all"`（默认 `all`）
-- `keyword`: 关键词
+## 登录（设备码）
 
-说明：
+1. 调用 `mcp_auth`，`{ "action": "start" }`
+2. 在浏览器打开返回的 `verificationUri`，按提示完成授权（可配合 `userCode`）
+3. 调用 `mcp_auth`，`{ "action": "poll" }`
+4. 使用 `auth.me` 确认已登录
 
-- 查询条件只保留 `assetType + keyword`
-- `keyword` 直接透传平台后端，因此搜索逻辑与平台当前页面一致
-- 不开放分页参数，固定查询第 1 页、每类最多 10 条
-- `assetType=all` 时：`rule/skill/mcp` 各返回最多 10 条
+可先调用 `{ "action": "methods" }` 查看说明。请在浏览器中登录，**不要**在对话里向 MCP 发送密码。
 
-## 工具入参（assets.create）
+## `assets.search`
 
-- `assetType`: `"rule" | "skill" | "mcp"`
-- `name`: 资产名称
-- `description`: 资产描述
-- `version`: 可选，默认 `v1.0`
-- `changeLog`: 可选，默认 `初始创建`
-- `content`: 可选（rule/skill）
-- `mcpType/configJson/toolsJson/remark`: 可选（mcp）
+- `assetType`：`rule` | `skill` | `mcp` | `all`（默认 `all`）
+- `keyword`：关键词，透传后端，与平台搜索一致；固定第 1 页，每类最多 10 条；`all` 时每类各最多 10 条
 
-## 说明
+## `assets.create`
 
-- token 存储在用户目录 `~/.asset-mcp/tokens.json`
-- 建议上线时切换到系统钥匙串存储（如 macOS Keychain）
+- `assetType`：`rule` | `skill` | `mcp`
+- `name`、`description`：必填（按后端校验）
+- `version`、`changeLog`、`content`（rule/skill）、`mcpType` / `configJson` / `toolsJson` / `remark`（mcp）等见平台接口约定

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asset-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "MIT",
   "description": "MCP server for asset operations in Cursor",
   "type": "module",

package/src/server.js

@@ -34,7 +34,7 @@ const TOOL_DEFS = [
   {
     name: 'assets.search',
     description:
-      '查询资产（rule/skill/mcp/all），GET /api/v1/assets/{assetType}；固定每类最多 10 条（第 1 页），无分页参数',
+      '查询资产（rule/skill/mcp/all），GET /api/v1/assets/{assetType}；固定每类最多 10 条（第 1 页），无分页参数。若用户只说「查询资产」等而未给出筛选条件，助手应先询问需要哪些条件，并列出可选：assetType、keyword、mine、status、categoryId/categoryIds、type（仅 mcp：local/remote）；用户补充或确认后再调用。',
     inputSchema: {
       type: 'object',
       properties: {