{"_id":"@bkyir/obsidian-mcp","_rev":"2-7bcce9d8eefecef19beb5f59a557294e","name":"@bkyir/obsidian-mcp","dist-tags":{"latest":"2.0.2"},"versions":{"2.0.1":{"name":"@bkyir/obsidian-mcp","version":"2.0.1","keywords":["obsidian","mcp","model-context-protocol","knowledge-base","notes","markdown","productivity","ai","claude","intelligent-analysis","knowledge-graph","ai-enhanced","smart-linking","content-analysis"],"author":{"name":"JianRuiDuTong Team"},"license":"MIT","_id":"@bkyir/obsidian-mcp@2.0.1","maintainers":[{"name":"bkyir","email":"r03z02@163.com"}],"homepage":"https://github.com/bkyir/obsidian-mcp","bugs":{"url":"https://github.com/bkyir/obsidian-mcp/issues"},"bin":{"obsidian-mcp":"build/index.js"},"dist":{"shasum":"f847216551d290cb247e76c872a18a68f1fdbb16","tarball":"https://registry.npmjs.org/@bkyir/obsidian-mcp/-/obsidian-mcp-2.0.1.tgz","fileCount":14,"integrity":"sha512-4YrE5pjWOoOZhvDnRt9QJPMabTcaV9pxs4WF0SXS0JFNxCB3BVVvr1L9tMizlie9gV/cSZ4M/2kfQ1BXYA8XAg==","signatures":[{"sig":"MEQCIEN9nXtfyIcXHAY8XPT9XGxeog+eV2ULWsO50fdzYz3ZAiBJ6DVoQ3hiwZpUMeg/QwjscGgPfCJUC7YT9jL5X2+iwg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":343288},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"e62d5cb03d9a05d5b07a42551bee77ab8c07ab41","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc && chmod +x build/index.js","start":"node build/index.js","docker:run":"docker-compose up -d","docker:logs":"docker-compose logs -f","docker:stop":"docker-compose down","docker:build":"docker build -t obsidian-mcp .","generate-dxt":"npm run build && node generate-dxt.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"bkyir","email":"r03z02@163.com"},"repository":{"url":"git+https://github.com/bkyir/obsidian-mcp.git","type":"git"},"_npmVersion":"11.8.0","description":"Enhanced Obsidian MCP Server with 25 Advanced AI Tools - Intelligent Knowledge Management with Smart Analysis, Auto-Linking, and Knowledge Graph Generation","directories":{},"_nodeVersion":"24.13.1","dependencies":{"diff":"^8.0.2","axios":"^1.8.2","dotenv":"^16.4.5","express":"^5.1.0","ts-node":"^10.9.2","archiver":"^7.0.1","node-fetch":"^3.3.2","typescript":"^5.8.2","@types/diff":"^7.0.2","eventsource":"^4.0.0","path-browserify":"^1.0.1","@modelcontextprotocol/sdk":"^1.6.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/obsidian-mcp_2.0.1_1777134527721_0.8011579192449216","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@bkyir/obsidian-mcp","version":"2.0.2","main":"build/index.js","type":"module","bin":{"obsidian-mcp":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","start":"node build/index.js","dev":"ts-node --esm src/index.ts","generate-dxt":"npm run build && node generate-dxt.js","prepublishOnly":"npm run build","docker:build":"docker build -t obsidian-mcp .","docker:run":"docker-compose up -d","docker:stop":"docker-compose down","docker:logs":"docker-compose logs -f"},"keywords":["obsidian","mcp","model-context-protocol","knowledge-base","notes","markdown","productivity","ai","claude","intelligent-analysis","knowledge-graph","ai-enhanced","smart-linking","content-analysis"],"author":{"name":"JianRuiDuTong Team"},"license":"MIT","description":"Enhanced Obsidian MCP Server with 25 Advanced AI Tools - Intelligent Knowledge Management with Smart Analysis, Auto-Linking, and Knowledge Graph Generation","repository":{"type":"git","url":"git+https://github.com/bkyir/obsidian-mcp.git"},"homepage":"https://github.com/bkyir/obsidian-mcp","bugs":{"url":"https://github.com/bkyir/obsidian-mcp/issues"},"engines":{"node":">=16.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.6.1","@types/diff":"^7.0.2","archiver":"^7.0.1","axios":"^1.8.2","diff":"^8.0.2","dotenv":"^16.4.5","eventsource":"^4.0.0","express":"^5.1.0","node-fetch":"^3.3.2","path-browserify":"^1.0.1","ts-node":"^10.9.2","typescript":"^5.8.2"},"devDependencies":{"@types/node":"^20.0.0"},"gitHead":"cab8b2f3e39f9460d092bc46783a8790e454c67b","types":"./build/index.d.ts","_id":"@bkyir/obsidian-mcp@2.0.2","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-DJD137aM46NEnSBiplW+/NEzSk80FHDL+2tFCtfKfCI97CDWkZQ23iSsh1UMDrodDikImRwO430Z5sQX7ylrng==","shasum":"9cd0285e2cd16b8c6cb50366922d40dae61d3cc9","tarball":"https://registry.npmjs.org/@bkyir/obsidian-mcp/-/obsidian-mcp-2.0.2.tgz","fileCount":14,"unpackedSize":349260,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDV9bUC5R3/3k5JQvZrVwP5DS/36ic4iVx4ixBwjz3DWQIgNfxWESpiV0+O29AMFHCiVZNbkhGx9Nt0BjDnYGeYTa8="}]},"_npmUser":{"name":"bkyir","email":"r03z02@163.com"},"directories":{},"maintainers":[{"name":"bkyir","email":"r03z02@163.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/obsidian-mcp_2.0.2_1777137394975_0.10278041506837043"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-25T16:28:47.662Z","modified":"2026-04-25T17:16:35.254Z","2.0.1":"2026-04-25T16:28:47.863Z","2.0.2":"2026-04-25T17:16:35.136Z"},"bugs":{"url":"https://github.com/bkyir/obsidian-mcp/issues"},"author":{"name":"JianRuiDuTong Team"},"license":"MIT","homepage":"https://github.com/bkyir/obsidian-mcp","keywords":["obsidian","mcp","model-context-protocol","knowledge-base","notes","markdown","productivity","ai","claude","intelligent-analysis","knowledge-graph","ai-enhanced","smart-linking","content-analysis"],"repository":{"type":"git","url":"git+https://github.com/bkyir/obsidian-mcp.git"},"description":"Enhanced Obsidian MCP Server with 25 Advanced AI Tools - Intelligent Knowledge Management with Smart Analysis, Auto-Linking, and Knowledge Graph Generation","maintainers":[{"name":"bkyir","email":"r03z02@163.com"}],"readme":"# Obsidian MCP 增强版服务器 - 25个AI智能工具\r\n\r\n[![npm version](https://badge.fury.io/js/@jianruidutong%2Fobsidian-mcp.svg)](https://badge.fury.io/js/@jianruidutong%2Fobsidian-mcp)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n[![Node.js Version](https://img.shields.io/badge/Node.js-%E2%89%A516.0.0-brightgreen)](https://nodejs.org/)\r\n\r\n[English](./README.md) | 中文\r\n\r\n这个项目实现了一个增强版 Model Context Protocol (MCP) 服务器，专为AI模型与Obsidian知识库的无缝集成而设计。提供**25个强大工具**，实现智能化知识管理、自动化内容分析和智能链接功能。\r\n### ✨ 基础特性\r\n- 🔗 **无缝 Obsidian 集成：**通过 MCP 协议直接访问 Obsidian 知识库\r\n- 📝 **完整的笔记管理：**使用高级文本替换功能阅读、创建、更新和删除笔记\r\n- 📁 **文件夹操作：**创建、重命名、移动和删除文件夹，并支持完整的层次结构\r\n- 🔍 **智能搜索：**通过智能评分对所有文件类型进行全文搜索\r\n- 🤖 **人工智能分析：**使用三难原则框架的全新战略洞察\r\n- 🔗 **自动反向链接生成：**全新智能检测笔记名称并将其转换为 wikilinks\r\n- ⚡ **精确编辑：**具有标题和块级定位的高级 PATCH 操作\r\n- 🚀 **双 API 策略：**Obsidian REST API 结合文件系统回退，实现最大可靠性\r\n- 🎯 **上下文优化：**用于 LLM 上下文长度管理的智能内容摘要\r\n- 📊 **批处理：**高效的批量操作，并带有进度跟踪\r\n### ✨ 新特性\r\n- 🧠 **15个全新AI增强工具** 实现智能内容分析\r\n- 🔗 **智能自动链接** 具备高级模式识别功能\r\n- 📊 **知识图谱生成** 可视化笔记关系网络\r\n- 🏷️ **高级标签管理** 智能标签推荐系统\r\n- 📝 **模板系统** 一致性笔记创建\r\n- 🔍 **内容相似度分析** 基于TF-IDF和余弦相似度\r\n- 📈 **关系分析** 发现隐藏连接\r\n\r\n## 🛠️ 完整工具套件（25个工具）\r\n\r\n### 📚 **核心笔记管理（10个工具）**\r\n\r\n#### 📄 **笔记操作**\r\n| 工具 | 描述 | 详细功能 |\r\n|------|------|----------|\r\n| `list_notes` | 列出知识库中的所有笔记，支持文件夹过滤 | 浏览库内容，按文件夹过滤，获取笔记元数据（大小、日期、路径） |\r\n| `read_note` | 读取单个笔记内容 | 获取完整笔记内容及元数据、文件统计信息和修改历史 |\r\n| `read_multiple_notes` | 批量同时读取多个笔记 | 高效加载多个笔记，适用于内容分析或批量操作 |\r\n| `create_note` | 创建带有内容的新笔记 | 生成新的markdown文件，自动创建目录结构 |\r\n| `update_note` | 高级内容编辑，支持精确定位 | 精准编辑笔记 - 替换文本、在指定位置插入、删除片段 |\r\n| `delete_note` | 从知识库中删除笔记 | 安全删除笔记，保持库的完整性 |\r\n| `move_note` | 重命名或移动笔记 | 在文件夹间移动笔记，重命名文件，自动更新链接 |\r\n\r\n#### 📁 **文件夹与组织**\r\n| 工具 | 描述 | 详细功能 |\r\n|------|------|----------|\r\n| `manage_folder` | 完整文件夹操作（创建/重命名/移动/删除） | 完整文件夹管理 - 创建嵌套结构，重组知识库层次 |\r\n| `search_vault` | 全文搜索所有内容 | 强大搜索支持正则表达式，上下文片段，相关性评分 |\r\n| `auto_backlink_vault` | 智能自动链接，具备模式识别功能 | 扫描整个知识库，检测内容中的笔记名称，自动转换为[[维基链接]] |\r\n\r\n### 🏷️ **标签管理系统（3个工具）**\r\n| 工具 | 描述 | 详细功能 |\r\n|------|------|----------|\r\n| `add_tags` | 为笔记添加多个标签 | 在笔记前言或内容中插入井号标签，支持嵌套标签（如 #项目/网络） |\r\n| `list_tags` | 列出所有标签及使用统计 | 全面标签清单，使用次数统计，排序选项，标签层次分析 |\r\n| `search_by_tags` | 高级基于标签的搜索，支持AND/OR操作符 | 复杂标签查询 - 查找具有特定标签组合的笔记，支持布尔逻辑 |\r\n\r\n### 📝 **模板系统（4个工具）**\r\n| 工具 | 描述 | 详细功能 |\r\n|------|------|----------|\r\n| `create_template` | 创建可重用的笔记模板，支持变量 | 设计带有{{变量}}的动态模板，支持日期、标题、自定义占位符 |\r\n| `list_templates` | 浏览可用模板 | 查看所有保存的模板及元数据、使用统计和变量信息 |\r\n| `apply_template` | 应用模板并进行变量替换 | 从模板生成新笔记，自动变量替换，自定义值注入 |\r\n| `delete_template` | 删除未使用的模板 | 清理模板库，维护模板组织结构 |\r\n\r\n### 🧠 **AI内容分析（4个工具）**\r\n| 工具 | 描述 | 详细功能 |\r\n|------|------|----------|\r\n| `extract_keywords` | 使用TF-IDF算法提取关键词 | 识别重要关键词和短语，统计相关性评分，可配置结果数量 |\r\n| `generate_summary` | 创建智能内容摘要 | 自动文本摘要，提取式摘要生成，可自定义长度 |\r\n| `suggest_tags` | AI驱动的标签推荐 | 分析内容并建议相关标签，从现有标签模式中学习 |\r\n| `find_similar_notes` | 使用余弦相似度发现相似内容 | 基于内容的相似性匹配，语义分析，基于阈值的过滤 |\r\n\r\n### 📊 **知识图谱与分析（4个工具）**\r\n| 工具 | 描述 | 详细功能 |\r\n|------|------|----------|\r\n| `analyze_note_relationships` | 全面的关系映射 | 映射笔记间连接，分析链接模式，识别知识集群 |\r\n| `generate_knowledge_graph` | 导出图数据供可视化工具使用 | 生成JSON/Cytoscape格式的网络数据，节点/边定义，兼容D3.js/Gephi |\r\n| `find_orphan_notes` | 识别孤立内容 | 检测无链接的笔记，发现断开的内容，知识库完整性分析 |\r\n| `suggest_connections` | AI驱动的连接推荐 | 基于内容相似性推荐潜在链接，发现隐藏关系 |\r\n\r\n## 🚀 快速开始\r\n\r\n### 方案1：NPM安装（推荐）\r\n\r\n**全局安装：**\r\n```bash\r\nnpm install -g @jianruidutong/obsidian-mcp\r\n```\r\n\r\n**或使用npx（无需安装）：**\r\n```bash\r\nnpx @jianruidutong/obsidian-mcp\r\n```\r\n\r\n### 方案2：从源码安装\r\n\r\n**克隆并构建：**\r\n```bash\r\ngit clone https://github.com/jianruidutong/obsidian-mcp.git\r\ncd obsidian-mcp\r\nnpm install\r\nnpm run build\r\nnpm start\r\n```\r\n\r\n### 方案3：Docker安装\r\n\r\n**Docker快速开始：**\r\n```bash\r\ngit clone https://github.com/jianruidutong/obsidian-mcp.git\r\ncd obsidian-mcp\r\ncp .env.example .env\r\n# 编辑 .env 设置知识库配置\r\ndocker-compose up -d\r\n```\r\n\r\n> 📚 **详细安装说明，请参阅 [安装指南](./INSTALLATION.md)**\r\n\r\n## ⚙️ 配置\r\n\r\n### MCP客户端配置\r\n\r\n#### 方式1：NPM安装配置\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"obsidian-mcp\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@jianruidutong/obsidian-mcp\"],\r\n      \"env\": {\r\n        \"OBSIDIAN_VAULT_PATH\": \"/path/to/your/vault\",\r\n        \"OBSIDIAN_API_TOKEN\": \"your_api_token\",\r\n        \"OBSIDIAN_API_PORT\": \"27123\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n#### 方式2：源码安装配置\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"obsidian-mcp\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"/path/to/obsidian-mcp/build/index.js\"],\r\n      \"env\": {\r\n        \"OBSIDIAN_VAULT_PATH\": \"/path/to/your/vault\",\r\n        \"OBSIDIAN_API_TOKEN\": \"your_api_token\",\r\n        \"OBSIDIAN_API_PORT\": \"27123\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n#### 方式3：Docker安装配置\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"obsidian-mcp\": {\r\n      \"command\": \"docker\",\r\n      \"args\": [\r\n        \"exec\",\r\n        \"-i\",\r\n        \"obsidian-mcp-server\", \r\n        \"npm\",\r\n        \"start\"\r\n      ],\r\n      \"env\": {\r\n        \"NODE_ENV\": \"production\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n**注意：**Docker部署时，环境变量在`.env`文件或`docker-compose.yml`中配置。\r\n\r\n### 环境变量\r\n| 变量名 | 描述 | 必需 | 默认值 |\r\n|----------|------|------|----------|\r\n| `OBSIDIAN_VAULT_PATH` | Obsidian知识库路径 | ✅ 是 | - |\r\n| `OBSIDIAN_API_TOKEN` | Local REST API令牌 | ✅ 是 | - |\r\n| `OBSIDIAN_API_PORT` | API端口号 | 🔧 建议 | 27123 |\r\n\r\n> 🔧 **所有配置选项，请参阅 [配置参考](./docs/configuration.md)**\r\n\r\n## 📋 前置条件\r\n\r\n1. **Node.js**（v16或更高版本）\r\n2. **Obsidian桌面应用程序**\r\n3. **Local REST API插件** 已安装在Obsidian中\r\n\r\n### 设置 Obsidian Local REST API\r\n\r\n1. 在Obsidian中安装\"Local REST API\"插件\r\n2. 在插件设置中生成API令牌\r\n3. 记下端口号（默认：27123）\r\n4. 确保插件已启用\r\n\r\n## 📚 文档\r\n\r\n- [📖 安装指南](./INSTALLATION.md) - 所有安装方法的完整指导\r\n- [🔧 配置参考](./docs/configuration.md) - 详细配置选项和故障排除\r\n- [🛠️ API文档](./docs/api.md) - 全部25个工具的完整API参考\r\n- [🚀 使用示例](./docs/examples.md) - 实用示例和真实应用场景\r\n\r\n## 🤝 贡献\r\n\r\n欢迎贡献！请查看我们的 [贡献指南](./CONTRIBUTING.md) 了解详情。\r\n\r\n### 开发环境设置\r\n```bash\r\ngit clone https://github.com/jianruidutong/obsidian-mcp.git\r\ncd obsidian-mcp\r\nnpm install\r\nnpm run dev\r\n```\r\n\r\n## 🐛 故障排除\r\n\r\n### 常见问题\r\n\r\n**连接被拒绝错误：**\r\n- 确保Obsidian Local REST API插件已安装并启用\r\n- 验证API令牌和端口号\r\n- 检查Obsidian是否正在运行\r\n\r\n**权限被拒绝：**\r\n- 验证知识库路径权限\r\n- 确保API令牌具有适当的访问权限\r\n\r\n**环境变量不工作：**\r\n- 对所有环境变量使用`OBSIDIAN_`前缀\r\n- 配置更改后重启MCP客户端\r\n\r\n> 🔍 **详细故障排除，请参阅 [配置参考](./docs/configuration.md)**\r\n\r\n## 📄 许可证\r\n\r\n本项目采用MIT许可证 - 详情请见 [LICENSE](LICENSE) 文件。\r\n\r\n## 🙏 致谢\r\n\r\n- [Model Context Protocol](https://github.com/anthropics/model-context-protocol) by Anthropic\r\n- [Obsidian Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) 插件\r\n- 原项目地址： https://github.com/newtype-01/obsidian-mcp\r\n\r\n## 📞 支持\r\n\r\n- 🐛 [报告问题](https://github.com/jianruidutong/obsidian-mcp/issues)\r\n- 💬 [讨论](https://github.com/jianruidutong/obsidian-mcp/discussions)\r\n\r\n---\r\n\r\n⭐ **如果觉得有用，请给仓库点个星！** ⭐\r\n","readmeFilename":"README.zh.md"}