mcpField
O
ObsidianFetch

ObsidianFetch

本地服务
ob.sou7.io记忆与知识22 天前更新

关于 ObsidianFetch

ObsidianFetch 是面向使用 Obsidian vault 的 LLM 的 MCP 服务,提供精简的笔记列表与读取功能。它会规范化链接搜索,并在读取笔记时附带反向链接。

主要功能

  1. 01按名称或文件夹搜索笔记
  2. 02按名称读取笔记
  3. 03返回同名笔记的全部结果
  4. 04规范化方括号链接搜索
  5. 05读取笔记时显示反向链接

适用场景

  1. 01按部分名称查找 vault 笔记
  2. 02无需先查路径即可读取指定笔记
  3. 03浏览与当前笔记互相链接的笔记

MCP 相关

它向 MCP 客户端提供 `list` 和 `read` 工具,可通过 stdio 或 Streamable HTTP 运行。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

ObsidianFetch

语言:日语

专注于从 Obsidian 知识库中获取和呈现信息的 MCP 服务。

现有 MCP 服务有以下缺点:

  • 支持许多命令,在计算资源有限时可能导致提示词加载缓慢。
  • 读取名为“示例笔记”的笔记时,需要先搜索其路径再加载,但大模型可能不会始终遵循此流程。
  • 某些工具包含不必要的选项,导致大模型有时无法正确调用它们。

在本地 GPU 上运行大模型时,这些问题尤为明显。
为解决这些问题,我们开发了一个新的 MCP 服务,只负责获取和加载笔记列表。

新服务还提供以下附加功能:

  • 当大模型尝试使用 [[link name]] 这样的方括号搜索链接信息时,服务会自动删除无法用于链接的字符。
  • 除了加载笔记内容,还会显示反向链接——即链接到当前打开笔记的笔记。
    • 这样,大模型就可以通过反向链接加载并理解相关笔记之间的联系。

安装

gem install obsidian_fetch

使用方法

Stdio 传输(默认)
obsidian_fetch /path/to/your/vault
Streamable HTTP 传输

要将服务作为 HTTP 服务运行:

obsidian_fetch /path/to/your/vault --transport streamable-http

默认情况下,服务会监听 http://localhost:9292。你可以自定义端口:

obsidian_fetch /path/to/your/vault --transport streamable-http --port 3000

工具

  • read:从 Obsidian 知识库中读取笔记。如果找到多篇同名笔记,则会全部显示。
  • list:搜索名称或所在文件夹名称部分匹配的笔记。默认返回 20 篇笔记。limit 参数接受 1 到 200 之间的整数,响应会说明匹配的笔记总数。

贡献

欢迎在 GitHub 上提交错误报告和拉取请求:https://github.com/soukouki/obsidian_fetch。

许可证

此 gem 根据 MIT 许可证 的条款以开源形式提供。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。