AI 에이전트에게 Obsidian 볼트에 대한 읽기/쓰기 권한을 부여하세요.
에이전트가 노트를 읽고, 새 노트를 생성하며, 동기화 상태를 유지합니다. 이 모든 과정은 Team Relay API를 통해 이루어집니다.
Claude Code, Codex CLI, OpenCode 및 모든 MCP 호환 클라이언트와 함께 작동합니다.
옵션 A — PyPI에서 설치 (권장):
별도의 설치가 필요 없습니다. uvx가 자동으로 다운로드하고 실행합니다. 2단계로 건너뛰세요.
옵션 B — 소스에서 설치:
git clone https://github.com/entire-vc/evc-team-relay-mcp.git
cd evc-team-relay-mcp
uv sync # or: pip install .Relay 자격 증명을 사용하여 도구의 구성에 MCP 서버를 추가하세요.
프로젝트 루트의 .mcp.json 또는 ~/.claude/.mcp.json에 추가하세요:
{
"mcpServers": {
"evc-relay": {
"command": "uvx",
"args": ["evc-team-relay-mcp"],
"env": {
"RELAY_CP_URL": "https://cp.yourdomain.com",
"RELAY_EMAIL": "agent@yourdomain.com",
"RELAY_PASSWORD": "your-password"
}
}
}
}codex.json에 추가하세요:
{
"mcp_servers": {
"evc-relay": {
"type": "stdio",
"command": "uvx",
"args": ["evc-team-relay-mcp"],
"env": {
"RELAY_CP_URL": "https://cp.yourdomain.com",
"RELAY_EMAIL": "agent@yourdomain.com",
"RELAY_PASSWORD": "your-password"
}
}
}
}opencode.json에 추가하세요:
{
"mcpServers": {
"evc-relay": {
"command": "uvx",
"args": ["evc-team-relay-mcp"],
"env": {
"RELAY_CP_URL": "https://cp.yourdomain.com",
"RELAY_EMAIL": "agent@yourdomain.com",
"RELAY_PASSWORD": "your-password"
}
}
}
}PyPI 대신 소스에서 설치한 경우, "command": "uvx" / "args": ["evc-team-relay-mcp"]를 다음으로 교체하세요:
"command": "uv",
"args": ["run", "--directory", "/path/to/evc-team-relay-mcp", "relay_mcp.py"]복사 가능한 구성 템플릿은 config/ 폴더에도 있습니다.
이제 AI 에이전트가 다음 도구를 사용할 수 있습니다:
도구 | 설명 |
| 자격 증명으로 인증 (자동 관리) |
| 액세스 가능한 공유 목록 (종류, 소유권별 필터링) |
| 폴더 공유 내 파일 목록 |
| 폴더 공유에서 경로별 파일 읽기 |
| doc_id별 문서 읽기 (저수준) |
| 경로별 파일 생성 또는 업데이트 |
| doc_id별 문서 쓰기 |
| 폴더 공유에서 파일 삭제 |
일반적인 워크플로우: list_shares -> list_files -> read_file / upsert_file
인증은 자동으로 수행됩니다. 서버가 내부적으로 로그인하고 토큰을 갱신합니다.
Related MCP server: Obsidian Knowledge Management MCP Server
공유 또는 서버 측 배포의 경우, HTTP 서버로 실행하세요:
# Direct
uv run relay_mcp.py --transport http --port 8888
# Docker
RELAY_CP_URL=https://cp.yourdomain.com \
RELAY_EMAIL=agent@yourdomain.com \
RELAY_PASSWORD=your-password \
docker compose up -d그런 다음 MCP 클라이언트가 HTTP를 통해 연결되도록 구성하세요:
{
"mcpServers": {
"evc-relay": {
"type": "streamable-http",
"url": "http://your-server:8888/mcp"
}
}
}이 MCP 서버는 셸 기반 통합보다 상당한 보안 이점을 제공합니다:
셸 실행 없음 — 모든 작업은 JSON-RPC를 통한 Python 함수 호출이므로 명령 주입 위험이 제거됩니다.
CLI 인수 없음 — 자격 증명과 토큰이 프로세스 인수로 전달되지 않습니다 (ps 출력에서 보이지 않음).
자동 토큰 관리 — 서버가 내부적으로 로그인, JWT 갱신 및 토큰 수명 주기를 처리합니다. 에이전트는 원시 토큰을 직접 다루지 않습니다.
타입 지정 입력 — 모든 매개변수는 실행 전에 JSON 스키마에 따라 검증됩니다.
단일 지속 프로세스 — 호출당 셸을 생성하지 않으며, 호출 간 환경 누출이 없습니다.
참고: OpenClaw 스킬 (bash 스크립트)을 사용 중이라면, 더 안전하고 유지 관리가 쉬운 이 MCP 서버로 마이그레이션하는 것을 고려하세요.
┌─────────────┐ MCP ┌──────────────┐ REST API ┌──────────────┐ Yjs CRDT ┌──────────────┐
│ AI Agent │ ◄────────────► │ MCP Server │ ◄─────────────► │ Team Relay │ ◄──────────────► │ Obsidian │
│ (any tool) │ stdio / HTTP │ (this repo) │ read/write │ Server │ real-time │ Client │
└─────────────┘ └──────────────┘ └──────────────┘ sync └──────────────┘MCP 서버는 Team Relay의 REST API를 표준 MCP 도구로 래핑합니다. Team Relay는 문서를 Yjs CRDT로 저장하고 Obsidian 클라이언트와 실시간으로 동기화합니다. 에이전트가 변경한 내용은 Obsidian에 즉시 나타나며, 그 반대의 경우도 마찬가지입니다.
Python 3.10+ 및 uv (권장) 또는 pip
실행 중인 EVC Team Relay 인스턴스 (자체 호스팅 또는 호스팅)
Relay 제어 평면의 사용자 계정
제품 | 기능 | 링크 |
Team Relay | 자체 호스팅 협업 서버 | |
Team Relay Plugin | Team Relay용 Obsidian 플러그인 | |
Relay MCP | AI 에이전트용 MCP 서버 | 이 저장소 |
OpenClaw Skill | OpenClaw 에이전트 스킬 (bash) | |
Local Sync | 볼트 <-> AI 개발 도구 동기화 | |
Spark MCP | AI 워크플로우 카탈로그용 MCP 서버 |
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/entire-vc/evc-team-relay-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server