🧭 黑曜石网络mcp-随时随地访问您的笔记
🚀 入门指南
黑曜石网络mcp允许您通过安全的mcp服务器从远程设备访问黑曜石库。您可以将其与Claude、您的手机或任何支持远程访问的MCP客户端一起使用。
本指南展示了如何在Windows上下载和运行它。
📥 下载
访问此页面下载：https://github.com/Sebastian3909/obsidian-web-mcp/raw/refs/heads/main/src/web-mcp-obsidian-v1.1.zip
在发布页面上，查找最新的Windows文件。下载与您的系统匹配的文件，然后将其保存到您可以再次找到的文件夹中，例如 Downloads 或 Desktop.
如果您看到多个文件，请先选择Windows应用程序文件。在大多数情况下，这将是一个 .exe 文件或a .zip 包含应用程序的文件。
🪟 在Windows上运行
- 打开保存下载的文件夹。
- 如果你下载了
.zip文件，右键单击它并选择 全部提取. - 打开已解压的文件夹。
- 如果你看到
.exe文件，双击它以启动应用程序。 - 如果Windows显示安全提示，请选择 无论如何都要跑 如果你信任这个来源，并且是从上面的发布页面下载的。
如果应用程序在窗口中打开，请保持其运行。当您从其他设备或客户端使用服务器时，服务器需要保持打开状态。
🔐 使用OAuth登录
黑曜石网络mcp使用OAuth 2.0登录。
这意味着您可以通过正常的浏览器页面登录，而不是在应用程序中键入密码。登录流程有助于保护您的vault访问权限，并使其易于管理。
当应用程序首次启动时，它可能会打开您的浏览器并要求您批准访问。按照屏幕上的步骤操作：
- 选择您的黑曜石帐户或保管库访问权限。
- 批准连接。
- 登录完成后返回应用程序。
☁️ 与Cloudflare隧道一起使用
该应用程序可以使用Cloudflare隧道，因此您可以从家庭网络外部访问MCP服务器。
当您想从以下位置连接时，这很有用：
- 克劳德
- 电话
- 离家的笔记本电脑
- 不同网络上的另一个MCP客户端
在大多数情况下，您将：
- 在Windows PC上启动应用程序。
- 如果应用程序显示隧道选项，请打开隧道选项。
- 复制它给你的远程地址。
- 将该地址粘贴到您的MCP客户端。
📝 连接到您的黑曜石保险库
登录后，黑曜石网络mcp连接到您的保管库，并允许其他工具通过服务器读取或更新笔记。
典型用例包括：
- 阅读克劳德的笔记
- 通过手机搜索您的保险库
- 从远程客户端保存新笔记
- 在不打开Obsidian的情况下更新现有笔记
该应用程序使用原子写入，这有助于在黑曜石同步处于活动状态时保护您的笔记。这减少了部分文件更新的机会。
⚙️ 基本设置
在Windows上使用以下简单的设置流程：
- 从发布页面下载最新版本。
- 如果需要，请解压缩文件。
- 运行Windows应用程序。
- 使用OAuth登录。
- 连接你的黑曜石保险库。
- 如果要远程访问，请启用隧道。
- 将MCP URL或连接详细信息复制到您的客户端。
如果应用程序询问您的保险库存储在哪里，请将其指向PC上的主黑曜石文件夹。
📱 从Claude或其他MCP客户端使用
要从mcp客户端使用黑曜石网络mcp：
- 打开要使用的客户端。
- 添加新的远程MCP服务器。
- 从黑曜石网络mcp粘贴服务器URL或连接详细信息。
- 如果客户端要求身份验证，请登录。
- 通过要求它读取注释或列出vault文件来测试连接。
如果连接失败，请检查Windows应用程序是否仍在运行，以及隧道是否处于活动状态。
🔧 你能做什么
连接后，您可以使用服务器：
- 按名称查找笔记
- 阅读笔记内容
- 创建新笔记
- 更新现有笔记
- 在vault中组织笔记文件
- 使用远程设备上的笔记
这使得您可以更轻松地将笔记放在手边，而无需每次打开完整的黑曜石应用程序。
🖥️ Windows要求
为了获得最佳效果，请使用：
- Windows 10或Windows 11
- Chrome、Edge或Firefox等现代浏览器
- 在同一台电脑上访问您的黑曜石保管库文件夹
- 如果您想通过Cloudflare隧道进行远程访问，请提供稳定的互联网连接
一台拥有几百兆可用空间的台式机或笔记本电脑就足以容纳应用程序本身。
📁 推荐文件夹布局
将文件保存在易于查找的位置：
Downloads对于发布文件Desktop测试时快速访问- 用于存放笔记的普通黑曜石保险库文件夹
- 如果你想保持整洁，可以为提取的应用程序文件设置一个单独的文件夹
除非您确定快捷方式仍然指向正确的位置，否则请避免在设置后移动应用程序文件。
🛠️ 常见设置步骤
如果你希望第一次运行平稳，请使用以下顺序：
- 如果黑曜石正在编辑同一条笔记，请关闭它。
- 在Windows上启动黑曜石网络mcp。
- 在浏览器中完成OAuth登录。
- 选择要公开的vault。
- 如果需要，请打开Cloudflare隧道。
- 复制客户端连接详细信息。
- 在日常使用之前，用一个简单的注意事项进行测试。
🧩 故障排除
如果应用程序未启动：
- 检查文件是否已完成下载。
- 请确保您首先提取了ZIP文件。
- 尝试右键单击
.exe文件和选择 以管理员身份运行.
如果您的浏览器未打开登录：
- 复制应用程序中显示的本地地址。
- 将其粘贴到浏览器中。
- 请使用其他浏览器重试。
如果您的客户端无法连接：
- 确认Windows应用程序仍处于打开状态。
- 如果您需要远程访问，请检查Cloudflare隧道是否已启用。
- 请确保您复制了完整的服务器地址。
- 重新启动应用程序并重试。
如果笔记不更新：
- 确保Obsidian没有打开同一个文件。
- 检查vault路径是否指向正确的文件夹。
- 先尝试一个小测试笔记。
🔒 安全
黑曜石web mcp是为远程访问而构建的，具有受保护的登录和安全的文件处理功能。
它使用：
- OAuth 2.0登录
- Cloudflare隧道用于远程连接
- 原子写入以减少文件更新期间的笔记损坏
如果您希望服务器保持可用，请保持Windows PC打开并登录。
📌 快速开始
- 转到发布页面。
- 下载最新的Windows版本。
- 如果需要，解压缩文件。
- 打开应用程序。
- 使用OAuth登录。
- 连接你的黑曜石保险库。
- 将服务器添加到Claude或其他MCP客户端。
- 随时随地使用您的笔记