@zsc-glitch/knowledge-keeper-mcp 0.2.0-alpha.1 → 0.3.0-alpha.1

package/README.md

@@ -1,15 +1,22 @@
 # Knowledge Keeper MCP Server
 
-> 智能知识管理的 Model Context Protocol 实现
+> 智能知识管理的 Model Context Protocol 实现，支持语义搜索
 
 ## 简介
 
 让 **knowledge-keeper** 可被 Claude Code、Cursor、Gemini CLI、Windsurf 等工具调用。
 
+## 特性
+
+- ✅ **7 个 MCP Tools** - 完整的知识管理
+- ✅ **语义搜索** - TF-IDF 向量嵌入，无外部依赖
+- ✅ **本地优先** - 所有数据存储在本地
+- ✅ **独立运行** - 不依赖 OpenClaw 运行时
+
 ## 安装
 
 ```bash
-npm install @zsc-glitch/knowledge-keeper-mcp
+npm install @zsc-glitch/knowledge-keeper-mcp@alpha
 ```
 
 ## 使用
@@ -39,19 +46,41 @@ claude mcp add knowledge-keeper -- npx @zsc-glitch/knowledge-keeper-mcp
 | Tool | 功能 |
 |------|------|
 | `knowledge_save` | 保存知识点 |
-| `knowledge_search` | 搜索知识 |
+| `knowledge_search` | 关键词搜索 |
+| `knowledge_semantic_search` | 🆕 语义搜索 |
 | `knowledge_get` | 获取单个知识点 |
 | `knowledge_update` | 更新知识点 |
 | `knowledge_delete` | 删除知识点 |
 | `knowledge_tags` | 列出标签 |
 
-## MCP Resources（计划）
+## MCP Resources
 
 | Resource | URI | 说明 |
 |----------|-----|------|
-| 知识点 | `knowledge:///{id}` | 单个知识点内容 |
-| 标签索引 | `knowledge:///tags` | 所有标签 |
-| 类型目录 | `knowledge:///type/{type}` | 按类型列出 |
+| 知识库概览 | `knowledge:///list` | 列出所有资源 |
+| 标签索引 | `knowledge:///tags` | 所有标签及计数 |
+| 概念类知识 | `knowledge:///type/concept` | 概念类知识点列表 |
+| 决策类知识 | `knowledge:///type/decision` | 决策类知识点列表 |
+| 待办事项 | `knowledge:///type/todo` | 待办类知识点列表 |
+| 笔记 | `knowledge:///type/note` | 笔记类知识点列表 |
+| 项目记录 | `knowledge:///type/project` | 项目类知识点列表 |
+
+## 数据存储
+
+- 默认位置：`~/.knowledge-vault/`
+- 知识点：`~/.knowledge-vault/{type}/{id}.md`
+- 向量索引：`~/.knowledge-vault/vectors.json`
+- 可通过环境变量 `KNOWLEDGE_KEEPER_DIR` 自定义
+
+## 语义搜索
+
+默认使用 TF-IDF 向量嵌入，无需额外依赖。
+
+**升级到 Transformer 模型：**
+```bash
+npm install @xenova/transformers
+EMBEDDING_MODEL=transformers npx @zsc-glitch/knowledge-keeper-mcp
+```
 
 ## 开发
 

package/dist/embedding.d.ts

@@ -3,9 +3,11 @@
  * 语义搜索模块 - 使用向量嵌入实现真正的语义搜索
  *
  * 技术方案：
- * - 嵌入模型: Xenova/all-MiniLM-L6-v2 (通过 @xenova/transformers)
- * - 向量存储: 本地 JSON 文件
- * - 相似度: 余弦相似度
+ * - 默认: TF-IDF 嵌入（轻量，无依赖）
+ * - 可选: @xenova/transformers 模型（需要安装额外依赖）
+ *
+ * 配置:
+ * - EMBEDDING_MODEL=tfidf (默认) 或 transformers
  */
 type Vector = number[];
 /**

package/dist/embedding.js

@@ -3,9 +3,11 @@
  * 语义搜索模块 - 使用向量嵌入实现真正的语义搜索
  *
  * 技术方案：
- * - 嵌入模型: Xenova/all-MiniLM-L6-v2 (通过 @xenova/transformers)
- * - 向量存储: 本地 JSON 文件
- * - 相似度: 余弦相似度
+ * - 默认: TF-IDF 嵌入（轻量，无依赖）
+ * - 可选: @xenova/transformers 模型（需要安装额外依赖）
+ *
+ * 配置:
+ * - EMBEDDING_MODEL=tfidf (默认) 或 transformers
  */
 import * as fs from "fs/promises";
 import * as path from "path";

package/dist/resources/index.d.ts

@@ -1,5 +1,6 @@
 /**
  * MCP Resources 注册
+ * 提供知识点的只读访问
  */
 import type { McpServer } from "@modelcontextprotocol/server";
 export declare function registerResources(server: McpServer): void;

package/dist/resources/index.js

@@ -1,10 +1,104 @@
 /**
  * MCP Resources 注册
+ * 提供知识点的只读访问
  */
+import { listTags, searchKnowledge } from "../core.js";
 export function registerResources(server) {
-    // TODO: 实现 Resources
-    // knowledge:///{id} - 单个知识点
-    // knowledge:///tags - 标签索引
-    // knowledge:///type/{type} - 按类型列出
+    // 资源列表（静态）
+    server.registerResource("knowledge-list", "knowledge:///list", {
+        title: "知识库概览",
+        description: "列出知识库中的所有知识点类型",
+        mimeType: "application/json",
+    }, async () => {
+        const tags = await listTags();
+        const tagCount = Object.keys(tags).length;
+        const totalEntries = Object.values(tags).reduce((a, b) => a + b, 0);
+        return {
+            contents: [
+                {
+                    uri: "knowledge:///list",
+                    text: JSON.stringify({
+                        message: "知识库资源列表",
+                        types: ["concept", "decision", "todo", "note", "project"],
+                        stats: {
+                            totalTags: tagCount,
+                            taggedEntries: totalEntries,
+                        },
+                        resources: [
+                            { uri: "knowledge:///tags", name: "标签索引" },
+                            { uri: "knowledge:///type/concept", name: "概念类知识" },
+                            { uri: "knowledge:///type/decision", name: "决策类知识" },
+                            { uri: "knowledge:///type/todo", name: "待办事项" },
+                            { uri: "knowledge:///type/note", name: "笔记" },
+                            { uri: "knowledge:///type/project", name: "项目记录" },
+                        ],
+                        usage: "使用 knowledge:///{id} 访问单个知识点",
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    // 标签索引
+    server.registerResource("knowledge-tags", "knowledge:///tags", {
+        title: "标签索引",
+        description: "知识库中所有标签的列表",
+        mimeType: "application/json",
+    }, async () => {
+        const tags = await listTags();
+        const sortedTags = Object.entries(tags)
+            .sort((a, b) => b[1] - a[1])
+            .map(([tag, count]) => ({ tag, count }));
+        return {
+            contents: [
+                {
+                    uri: "knowledge:///tags",
+                    text: JSON.stringify({
+                        total: sortedTags.length,
+                        tags: sortedTags,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    // 按类型列出
+    const types = ["concept", "decision", "todo", "note", "project"];
+    const typeNames = {
+        concept: "概念类知识",
+        decision: "决策类知识",
+        todo: "待办事项",
+        note: "笔记",
+        project: "项目记录",
+    };
+    for (const type of types) {
+        server.registerResource(`knowledge-type-${type}`, `knowledge:///type/${type}`, {
+            title: typeNames[type],
+            description: `列出所有${typeNames[type]}`,
+            mimeType: "application/json",
+        }, async () => {
+            const results = await searchKnowledge({
+                query: "",
+                type,
+                limit: 100,
+            });
+            return {
+                contents: [
+                    {
+                        uri: `knowledge:///type/${type}`,
+                        text: JSON.stringify({
+                            type,
+                            name: typeNames[type],
+                            count: results.length,
+                            entries: results.map((kp) => ({
+                                id: kp.id,
+                                title: kp.title,
+                                tags: kp.tags,
+                                created: kp.created,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        });
+    }
 }
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zsc-glitch/knowledge-keeper-mcp",
-  "version": "0.2.0-alpha.1",
-  "description": "MCP Server for Knowledge Keeper - 智能知识管理的 Model Context Protocol 实现，支持语义搜索",
+  "version": "0.3.0-alpha.1",
+  "description": "MCP Server for Knowledge Keeper - 智能知识管理的 Model Context Protocol 实现，支持语义搜索和资源访问",
   "type": "module",
   "main": "dist/index.js",
   "bin": {