acuvity/mcp-server-obsidian

什么是mcp-server-obsidian？

描述：通过REST API与Obsidian交互。
由Acuvity打包并发布到我们的精选MCP服务器https://mcp.acuvity.ai，基于mcp-obsidian原始https://github.com/MarkusPfundstein/mcp-obsidian。

快速链接：

• https://github.com/acuvity/mcp-servers-registry/blob/main/mcp-server-obsidian/docker/README.md#-clients-integrations
• https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-obsidian/docker/README.md#-run-it-with-docker
• https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-obsidian/charts/mcp-server-obsidian/README.md#how-to-install

我们为何构建此镜像

在https://acuvity.ai，安全是我们使命的核心——尤其是对于MCP服务器和智能代理系统集成等关键系统。为满足这一需求，我们创建了安全可靠的Docker镜像，确保mcp-obsidian可靠且安全地运行。

🔐 核心安全特性

📦 隔离的不可变沙箱

🛡️ 运行时安全与护栏

Minibridge集成：https://github.com/acuvity/minibridge建立安全的Agent-to-MCP连接，支持Rego/HTTP-based策略执行，并简化编排。

ARC容器包含https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-obsidian/docker/policy.rego，提供一系列运行时https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-obsidian#️-guardrails，以执行安全、隐私和服务正确使用的规则。

快速参考

维护者：

• Acuvity团队（打包）
• Markus Pfundstein（原始应用）

支持渠道：

• https://github.com/acuvity/mcp-servers-registry
• Acuvity社区***

支持架构：amd64、arm64
基础镜像：ghcr.io/astral-sh/uv:python3.12-alpine

📦 安装方法

环境变量要求：

• OBSIDIAN_API_KEY（必填）
• OBSIDIAN_HOST（必填）

🐳 Docker运行示例

本地HTTP/sse模式

bash
docker run -it -p 8000:8000 --rm --read-only -e OBSIDIAN_API_KEY=your_key -e OBSIDIAN_HOST=your_host docker.xuanyuan.run/acuvity/mcp-server-obsidian:0.2.2

客户端配置示例（VS Code全局设置）

在Preferences: Open User Settings JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-obsidian": {
        "env": {
          "OBSIDIAN_API_KEY": "TO_BE_SET",
          "OBSIDIAN_HOST": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "OBSIDIAN_API_KEY",
          "-e",
          "OBSIDIAN_HOST",
          "docker.io/acuvity/mcp-server-obsidian:0.2.2"
        ]
      }
    }
  }
}

☁️ Kubernetes部署（Helm）

bash
helm install mcp-server-obsidian oci://docker.io/acuvity/mcp-server-obsidian --version 1.0.0 --set secrets.OBSIDIAN_API_KEY.value=your_key --set env.OBSIDIAN_HOST=your_host

🧠 服务器功能

详细功能列表请参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-obsidian。

💬 问题反馈：https://github.com/acuvity/mcp-servers-registry/issues
📦 欢迎贡献！

注意：使用前请替换环境变量中的TO_BE_SET为实际值，并确保遵守相关服务的使用条款。