@devflow-tools/mcp-server 0.17.5 → 0.17.6

package/README.md

@@ -1,63 +1,44 @@
 # @devflow-tools/mcp-server
 
-DevFlow MCP (Model Context Protocol) 服务端 — 为 AI Agent 提供代码上下文、符号搜索、依赖图谱、工作流、记忆和知识库查询。
+> 通过 Model Context Protocol 暴露上下文、符号、依赖图、工作流、记忆和知识查询。（v0.17.6）
 
-## Installation
+[![npm version](https://img.shields.io/npm/v/%40devflow-tools%2Fmcp-server.svg)](https://www.npmjs.com/package/@devflow-tools/mcp-server)
+
+## 安装
 
 ```bash
-npm install -g @devflow-tools/mcp-server
+npm install @devflow-tools/mcp-server
 ```
 
-或通过 npx 使用：
+## 快速开始
 
 ```bash
-npx @devflow-tools/mcp-server
+npx @devflow-tools/mcp-server --help
+# MCP client command: npx @devflow-tools/mcp-server
 ```
 
-## Configuration
-
-在 MCP client 配置中添加（`.claude/mcp.json`、`claude_desktop_config.json` 等）：
-
-```json
-{
-  "mcpServers": {
-    "devflow": {
-      "command": "npx",
-      "args": ["@devflow-tools/mcp-server"]
-    }
-  }
-}
-```
+## 公共 API / 命令
 
-也可以让 `devflow init` 自动处理配置。
+binary `devflow-mcp`；工具包括 `get_project_context`、`search_symbol`、`get_dependency_graph`、`run_workflow`、`get_memory`、`get_knowledge`。
 
-## MCP Tools
 
-| Tool | 说明 | 关键参数 |
-|------|------|---------|
-| `get_project_context` | 获取任务级上下文（含风险提示、下一步行动） | `query`, `mode` (fast/deep) |
-| `search_symbol` | 按符号名搜索代码结构 | `symbol` |
-| `get_dependency_graph` | 获取文件/组件的依赖关系 | `target`, `depth` |
-| `run_workflow` | 执行标准化开发工作流 | `type` (bugfix/feature/review), `input` |
-| `get_memory` | 获取项目记忆（技术栈、约定、偏好） | — |
-| `get_knowledge` | 查询技术文档知识库 | `query`, `scope` (react/vue/nest/all) |
+二进制入口：
+- `devflow-mcp`
 
-## Run Modes
+## 配置与运行时
 
-- **Local mode** — DevFlow 服务端不可达时，回退到直接 CodeGraph 查询
-- **Remote mode** — 代理到 DevFlow REST API 服务端
+支持 stdio 和 SSE；优先通过 `devflow init` 写入客户端配置。远程模式读取 `DEVFLOW_SERVER_URL`，服务不可用时回退到本地查询。
 
-## Environment Variables
+## 版本与兼容性
 
-| 变量 | 默认值 | 说明 |
-|------|--------|------|
-| `DEVFLOW_SERVER_URL` | `http://127.0.0.1:13337` | DevFlow 服务端地址 |
-| `DEVFLOW_PROJECT_ROOT` | `cwd` | 项目根目录 |
-| `DEVFLOW_API_KEY` | 读取生成的本地密钥 | API 认证密钥；未设置时使用 `~/.devflow/keys/local.key` |
+- 当前包版本：`0.17.6`
+- Node.js：未在 package manifest 声明更高版本时，使用 Node.js 18+；原生 SQLite/Playwright 能力请按对应依赖安装
+- workspace 内部包应使用同一 DevFlow minor/patch 版本，避免类型和数据库 schema 不一致
 
-## Transport
+## 相关链接
 
-支持 stdio 和 SSE 两种传输模式。
+- [DevFlow 仓库](https://github.com/shilongfeicool/dev-flow)
+- [问题反馈](https://github.com/shilongfeicool/dev-flow/issues)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/mcp-server",
-  "version": "0.17.5",
+  "version": "0.17.6",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
@@ -14,13 +14,13 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@devflow-tools/context-engine": "0.17.5",
-    "@devflow-tools/database": "0.17.4",
-    "@devflow-tools/knowledge-engine": "0.17.5",
-    "@devflow-tools/memory-engine": "0.17.5",
-    "@devflow-tools/sdk": "0.17.5",
-    "@devflow-tools/telemetry": "0.17.5",
-    "@devflow-tools/workflow-engine": "0.17.5",
+    "@devflow-tools/context-engine": "0.17.6",
+    "@devflow-tools/database": "0.17.6",
+    "@devflow-tools/knowledge-engine": "0.17.6",
+    "@devflow-tools/memory-engine": "0.17.6",
+    "@devflow-tools/sdk": "0.17.6",
+    "@devflow-tools/telemetry": "0.17.6",
+    "@devflow-tools/workflow-engine": "0.17.6",
     "@modelcontextprotocol/sdk": "^1.0.0"
   },
   "devDependencies": {
@@ -31,5 +31,5 @@
     "dist",
     "bin"
   ],
-  "gitHead": "817b0286c249eed9c2bd27d3974ee3b3d6ded4bb"
+  "gitHead": "669fea3aa72aa3fde14ed50d24c1fec4dfac088f"
 }