Skip to main content
Glama

EVC Team Relay - MCPサーバー

PyPI License: MIT MCP Install via Spark

AIエージェントにObsidianボルトへの読み取り/書き込み権限を与えましょう。

エージェントがノートを読み取り、新規作成し、同期を維持します。これらすべてをTeam Relay API経由で行います。

Claude CodeCodex CLIOpenCode、および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エージェントは以下のツールを使用できるようになります:

ツール

説明

authenticate

認証情報で認証(自動管理)

list_shares

アクセス可能な共有を一覧表示(種類や所有権でフィルタリング)

list_files

フォルダー共有内のファイルを一覧表示

read_file

フォルダー共有からパスを指定してファイルを読み取り

read_document

doc_idでドキュメントを読み取り(低レベル)

upsert_file

パスを指定してファイルを作成または更新

write_document

doc_idでドキュメントに書き込み

delete_file

フォルダー共有からファイルを削除

一般的なワークフロー: 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

セルフホスト型コラボレーションサーバー

repo

Team Relay Plugin

Team Relay用Obsidianプラグイン

repo

Relay MCP

AIエージェント用MCPサーバー

このリポジトリ

OpenClaw Skill

OpenClawエージェントスキル (bash)

repo

Local Sync

ボルト <-> AI開発ツール同期

repo

Spark MCP

AIワークフローカタログ用MCPサーバー

repo

コミュニティ

ライセンス

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

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

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

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