evc-team-relay-mcp
EVC Team Relay - MCPサーバー
AIエージェントにObsidianボルトへの読み取り/書き込み権限を与えましょう。
エージェントがノートを読み取り、新規作成し、同期を維持します。これらすべてをTeam Relay API経由で行います。
Claude Code、Codex CLI、OpenCode、およびMCP互換クライアントで動作します。
クイックスタート
1. インストール
オプション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 .2. AIツールの設定
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/にもあります。
3. 使用方法
AIエージェントは以下のツールを使用できるようになります:
ツール | 説明 |
| 認証情報で認証(自動管理) |
| アクセス可能な共有を一覧表示(種類や所有権でフィルタリング) |
| フォルダー共有内のファイルを一覧表示 |
| フォルダー共有からパスを指定してファイルを読み取り |
| doc_idでドキュメントを読み取り(低レベル) |
| パスを指定してファイルを作成または更新 |
| doc_idでドキュメントに書き込み |
| フォルダー共有からファイルを削除 |
一般的なワークフロー: list_shares -> list_files -> read_file / upsert_file
認証は自動的に行われます。サーバーがログインし、内部でトークンをリフレッシュします。
Related MCP server: Obsidian Knowledge Management MCP Server
リモートデプロイ(HTTPトランスポート)
共有環境やサーバーサイドでのデプロイには、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 skill(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コントロールプレーン上のユーザーアカウント
Entire VCツールボックスの一部
製品 | 機能 | リンク |
Team Relay | セルフホスト型コラボレーションサーバー | |
Team Relay Plugin | Team Relay用Obsidianプラグイン | |
Relay MCP | AIエージェント用MCPサーバー | このリポジトリ |
OpenClaw Skill | OpenClawエージェントスキル (bash) | |
Local Sync | ボルト <-> AI開発ツール同期 | |
Spark MCP | AIワークフローカタログ用MCPサーバー |
コミュニティ
ライセンス
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables direct file system access to Obsidian vaults with auto-discovery, full-text search, and note operations. Supports reading, writing, and searching across Obsidian notes without requiring plugins or REST API.63,860MIT
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to read, search, and manage Obsidian vault markdown files, including YAML frontmatter, wikilinks, and graph operations through a secure stateless I/O layer.
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.3,860
- FlicenseNot gradedqualityDmaintenanceProvides secure, direct file system access to Obsidian vault files, enabling search, read, write, and discovery of notes without requiring the Obsidian app.23
Related MCP Connectors
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…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
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