arcology
Verified Safeby zvxr
Overview
Self-hosting an MCP (Multi-Modal AI Collaboration Protocol) server to integrate AI agents with an Obsidian knowledge base.
Installation
make runEnvironment Variables
- OBSIDIAN_API_KEY
- ARCOLOGY_MCP_KEY
- OBSIDIAN_REST_API_URL
- NGROK_AUTHTOKEN
- OBSIDIAN_HOST
- OBSIDIAN_PROTOCOL
- OBSIDIAN_PORT
- MCP_PORT
- MCP_ENDPOINT_URL
- MCP_FIRST
- OBSIDIAN_VERIFY_SSL
Security Notes
The project uses ngrok to expose local services to the public internet via an HTTPS tunnel, which inherently introduces a significant network attack surface. This risk is mitigated by requiring an `ARCOLOGY_MCP_KEY` for authentication to the MCP bridge. The `patches/mcp_obsidian/tools.py` implements a `ComplexSearchToolHandler` that passes a `JsonLogic` query directly to the `obsidian-local-rest-api`. While this server does not execute `JsonLogic` itself, it acts as a proxy, making its security dependent on the robustness of the underlying Obsidian REST API's handling of such complex queries, especially if the AI agent is compromised or malicious. No hardcoded secrets or direct `eval`/`exec` of untrusted user input within this server's Python code were found. The `DeleteFileToolHandler` requires explicit confirmation, which is a good safety measure.
Similar Servers
mcp-obsidian
Provides a secure, universal AI bridge for Obsidian vaults, enabling MCP-compatible AI assistants to read, write, and manage notes.
obsidian-mcp-plugin
This plugin connects your Obsidian vault to AI assistants through MCP (Model Context Protocol), enabling them to understand and navigate your notes as a connected knowledge graph.
mcp-obsidian
Enables LLMs (like Claude) to programmatically interact with an Obsidian vault through the Local REST API plugin.
obsidian-mcp-server
Provides an OpenAI-compatible local Model Context Protocol (MCP) server within Obsidian, enabling external AI assistants and tools to semantically search the vault and perform file system operations.