MCP Obsidian Local

MCP浏览器工具

提供方 jooooou

浏览器工具 未标注 无需鉴权 社区 / 第三方 Claude

一个基于技能的本地AI代理,用于在Obsidian中作为个人助手,支持内容创建、文件搜索和Obsidian命令执行。

一句话选型结论

按资料字段整理

MCP Obsidian Local 属于浏览器工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类浏览器工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

浏览器工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

本地AIPython本地部署Obsidian插件内容生成文件搜索自动化

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在浏览器工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Obsidian Local当前 4 未标注 未标注 无 2026-05-17
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方jooooou上游标注的维护方 jooooou
分类浏览器工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.3 KB
来自项目仓库与上游目录的原文,未做删改

🧠 本地黑曜石人工智能代理(基于技能)

这个项目实施了一个 自主本地 AI 代理 被设计成Obsidian内部的个人助理。与传统机器人不同,此代理使用基于 技能(Skills)它的灵感来自OpenClaw和Claude Code等现代框架。

该代理能够读取您的笔记,创建内容,深入搜索您的文件系统,并以本地和私密方式执行Obsidian命令。


🏗️ 系统架构

该架构分为两个主要组件,通过推理循环(ReAct)共同工作:

1. 代理核心(agent.py)

系统的“大脑”。它管理语言模型(LLM)和执行界面。

  • LLM发动机: 使用 llama.cpp 以 GPU 加速运行 GGUF 模型。
  • 程序化工具调用: 代理具有用Python编写的“原生”工具,可以通过结构化的JSON调用:
  • list_skills列出可用的操作手册。
  • load_skill: 为对话上下文加载特定技能的手册。
  • execute_shell允许代理执行Bash命令(如 curl, grep, ls).
  • read_file: 直接从磁盘读取文件 。
  • 上下文管理: 监控令牌使用情况并管理对话历史记录,以保持代理集中并在模型内存限制范围内。

2.技能体系(skills/)

这些功能在 Python 中不是“硬编码”。相反,它们在Markdown文件中定义(SKILL.md).

  • 动态学习: 经纪人开始“干净”。当他发现一个问题时,他发现有一个技能(例如: obsidian阅读手册,立即学习如何使用CLI工具(如 curl Obsidian API)来解决请求。
  • 灵活性: 添加新功能(例如与Git集成,Python REPL,Dataview)就像创建一个带有解释性Markdown文件的新文件夹一样简单。

🛠️ 工具如何工作

循环反应(Loop React)

  1. 思考(``): 模型分析用户的请求,并决定需要什么工具或技能。
  2. **工具调用`):** 模板生成一个描述动作的JSON(例如:调用)execute_shell用一个命令curl`).
  3. 执行 : O agent.py 拦截该JSON,在终端中执行Python代码或命令,并捕获结果(stdout/stderr)。
  4. 注释 : 结果作为新的上下文消息返回到模型。
  5. 最终答案: 模型会处理结果并对用户做出响应,或者决定是否需要执行另一个步骤。

与Obsidian的整合

代理以两种冗余和强大的方式与Obsidian交互:

  • API REST本地: 通过comandos curl 在技能中记录,代理与插件交谈 黑名单本地REST API 用于界面操作(打开笔记,运行应用程序命令)。
  • 直接磁盘访问 : 对于全文搜索,代理使用 Linux 原生工具,如 grep e ls 在变量定义的文件夹中 OBSIDIAN_VAULT_PATH这可以绕过第三方插件的限制或错误,并确保即时速度。

📋 安装和配置

1.先决条件

  • 型号gguf: 指令模板(推荐:Qwen 2.5 7B 或 Llama 3.1 8B)。
  • 黑曜石插件: 安装并激活插件 本地REST API 在你的Obsidian

2. 环境设置

创建文件 .env 工程根 :```ini

Caminho para o modelo GGUF

MODEL_PATH=/caminho/para/seu/modelo.gguf

Configurações do Obsidian

OBSIDIAN_API_TOKEN=seu_token_aqui
OBSIDIAN_VAULT_PATH=/home/usuario/Documents/Vault


### 3. 安装```bash
make install

🚀 使用

使用命令启动代理 :bash make agent

您可以要求:

  • “我对X项目有什么看法?” (他会找到并阅读笔记)。
  • “在我今天的待办事项列表中添加‘最终审查’步骤。 (他会找到你的每日笔记并使用 PATCH 编辑)。
  • “查找所有提到‘AI’的笔记,然后给我一个摘要。 (他将使用 grep 递归和处理文件)。

🛡️ 安全与隐私

  • 100%本地: 没有什么从你的机器出来。人工智能处理和文件访问是在本地进行的。
  • 透明度 : 代理在终端上打印您正在运行的每个命令,允许您实时审核操作。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Obsidian Local 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Obsidian Local 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Obsidian Local 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Obsidian Local 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Obsidian Local 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Obsidian Local 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 本地AI、内容生成、Python、Claude、文件搜索。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。