mcp-obsidian-docker

MCP Obsidian Docker

This is a containerized version of MCP Obsidian, a server that interacts with Obsidian via the Local REST API community plugin.

Prerequisites

1. Docker and Docker Compose installed
2. Obsidian with the Local REST API plugin installed and configured
3. API key from the Local REST API plugin

API Key Configuration

Getting Your API Key

1. Open Obsidian
2. Go to Settings (gear icon in the bottom left)
3. Select "Community Plugins" in the left sidebar
4. Find "Local REST API" in your list of installed plugins
5. Click the settings gear icon (⚙️) next to the plugin
6. Look for the "API Key" field - this is your authentication key

Setting Up the API Key

1. Create your environment file by copying the example:

   cp .env.example .env
   

2. Edit the .env file:

   # Open with your preferred editor
   nano .env
   # or
   vim .env
   # or any text editor
   

3. Replace the placeholder with your actual API key:

   # Before:
   OBSIDIAN_API_KEY=your_api_key_here
   
   # After (example - use your actual key):
   OBSIDIAN_API_KEY=1234abcd5678efgh
   

Security Notes

• The .env file is listed in .gitignore to prevent accidental commits
• Never share your API key or commit it to version control
• If you need to change your API key:
  1. Generate a new key in Obsidian
  2. Update your .env file
  3. Restart the container: docker-compose restart

Setup

1. Clone this repository
2. Configure API key as described above
3. Build and start the container:

   docker-compose up -d
   

Usage

The MCP Obsidian server will be available at port 27124. Make sure this port matches the one configured in your Obsidian Local REST API plugin.

Verifying the Setup

1. Check if the container is running:

   docker-compose ps
   

2. Check the logs for any issues:

   docker-compose logs -f
   

3. If you see authentication errors, verify your API key is correctly set in the .env file

Common Issues

1. Authentication Failed: Double-check your API key in both Obsidian plugin settings and .env file
2. Connection Refused: Ensure Obsidian is running and the Local REST API plugin is enabled
3. Port Conflict: If port 27124 is already in use, you can modify the port mapping in docker-compose.yml

Logs

Logs are stored in the ./logs directory, which is mounted as a volume in the container.

Environment Variables

• OBSIDIAN_API_KEY: Your Obsidian Local REST API plugin API key (required)

License

This project is licensed under the MIT License - see the original MCP Obsidian repository for details.