옵시디언 - MCP Server

개요

목표

• 클로드 데스크탑(Claude Desktop)을 통해 얻은 지식을 로컬 PC의 옵시디언(Obsidian)에 저장해둔다.
• 그러면서도 안전하게, 무료로 GitHub에 자동 백업을 한다.
• 참고 링크:
  • https://youtu.be/tOCVAG7UkqM?si=DJIqARUZZ1MMgRjQ
  • https://youtu.be/_PiRCPnQmgk?si=wAe0K4y49uiLCTvL

도구

• GitHub 백업을 위한 옵시디언 커뮤니티 플러그인: Obsidian Git
• MCP 서버 연동을 위한 옵시디언 커뮤니티 플러그인: Local REST API
• 클로드 데스크탑에서 로컬 옵시디언과 연동하기 위한 MCP 서버

순서

1. 옵시디언 GitHub 백업 설정하기
2. 옵시디언 MCP 서버 설정하기

이번 글에서는 MCP 서버를 설정해보자.

옵시디언 MCP 서버

Local REST API

볼트의 설정에서 커뮤니티 플러그인을 설치한다. Local REST API 이다.

 

 

Install → Enable 후에는 Option을 설정해야 하는데 로컬서버이기에 HTTPS 가 아닌 HTTP가 가능하도록 설정하였다.

MCP 서버에 적용해야할 정보들이 여기에 모두 있다.

• IP, Port: http://127.0.0.1
• Port: 27123
• API Key

 

MCP Server

옵시디언을 위한 MCP 서버는 여럿이 있는데 다음을 사용하겠다.

GitHub: https://github.com/MarkusPfundstein/mcp-obsidian

README.md 파일에 안내된 대로 설정만 하면 된다.

{
  "mcp-obsidian": {
    "command": "uvx",
    "args": [
      "mcp-obsidian"
    ],
    "env": {
      "OBSIDIAN_API_KEY": "<your_api_key_here>",
      "OBSIDIAN_HOST": "<your_obsidian_host>",
      "OBSIDIAN_PORT": "<your_obsidian_port>"
    }
  }
}

클로드 데스크탑의 MCP 설정에서 위 내용을 추가해주면 된다.

Settings → Developer → Edit Con

fig 버튼을 누르면 어떤 JSON 파일에 추가해야 할지 확인할 수 있다.

 

 

 

나의 경우는 다음 파일이었다.

/Users/hyunseokjeong/Library/Application Support/Claude/claude_desktop_config.json

다음과 같이 추가를 해주었다

• 본인 컴퓨터의 uvx 위치를 확인하려면 which uvx 명령을 사용하면 된다.
• OBSIDIAN_HOST, OBSIDIAN_PORT 값은 디폴트 값이라 필요없을것 같아 넣지 않았는데 문제 없었다..
  • 디폴트로는 HTTPS로 가게 되어서인지 문제가 있어서 두 값을 명시적으로 넣어주었다.

{
  "globalShortcut": "Alt+Space",
  "mcpServers": {
    "mcp-obsidian": {
      "command": "/Users/hyunseokjeong/.local/bin/uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "bf9cf64824157ca2983a741a19787a8cdc334ed5bdc863bd566e3ae99f2cb39d",
        "OBSIDIAN_HOST": "http://127.0.0.1",
        "OBSIDIAN_PORT": "27123"
      }
    }
  }
}

작동 시켜보기

우선 클로드 데스크탑을 재시작하여 변경사항이 적용되도록 하자.

다음과 같이 적용이 된 것을 확인할 수 있다. 이제 클로드 데스크탑과 옵시디언, 정확히는 옵시디언의 특정 볼트와 연결이 된 것이다.

 

 

 

클로드와 대화를 나눈 다음, 정보를 정리해서 옵시디언에 저장해달라고만 하면 된다.

 

옵시디언에 저장이 되고, 다시 GitHub으로 백업이 되는 것을 확인할 수 있다.

마무리

클로드와 대화하는 내용을 정리해서 저장해두고 싶은 욕심에 여기까지 알아보았다. 더 나은 방법이나 현재 구현의 활용방안이 있다면 들어보고 싶다.