Endara 中继

Prerequisites

• Rust (stable, 2021 edition)
• macOS, Linux, or Windows

1. Install

```bash

Building from Source

Build

git clone https://github.com/endara-ai/endara-relay.git
cd endara-relay
cargo build --release

The binary will be at target/release/endara-relay.

Quick Start

2. Create a config file

mkdir -p ~/.endara
cat > ~/.endara/config.toml << 'EOF'
[relay]
machine_name = "my-laptop"

[[endpoints]]
name = "filesystem"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]

[[endpoints]]
name = "github"
transport = "stdio"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_TOKEN = "$GITHUB_TOKEN" }
EOF

Configuration

The config file is TOML. Here's a complete reference:

```toml [relay] machine_name = "my-laptop" # Required — identifies this machine local_js_execution = true # Optional — enable JS execution mode (default: false) toon_output = true # Optional — convert JSON tool responses to TOON (default: true)

Optional — override the advertised server_type

Environment variable resolution

Environment variables in env maps are resolved at startup:

Config hot-reload

Relay watches your config file for changes using the notify crate. When you save the file, Relay automatically:

• Starts adapters for newly added endpoints
• Stops adapters for removed endpoints
• Restarts adapters for changed endpoints
• Leaves unchanged endpoints running

No restart required.

STDIO endpoint — spawns a child process

[[endpoints]] name = "github" # Required — unique name, used as tool prefix transport = "stdio" # Required — "stdio", "sse", or "http" command = "npx" # Required for stdio — command to run args = ["-y", "@modelcontextprotocol/server-github"] # Optional — command arguments env = { GITHUB_TOKEN = "$GITHUB_TOKEN" } # Optional — environment variables

SSE endpoint — connects to a Server-Sent Events MCP server

[[endpoints]] name = "remote-server" transport = "sse" url = "http://localhost:3001/sse" # Required for sse/http — server URL

HTTP endpoint — connects via JSON-RPC over HTTP

[[endpoints]] name = "http-server" transport = "http" url = "http://localhost:4000/mcp" # Required for sse/http — server URL

Management API

Relay exposes a management REST API for monitoring and control. The API is reachable only through an OS-local Unix-domain socket (Linux/macOS) or Named Pipe (Windows) created per-user with 0600 permissions; it is not bound to TCP.

Example (Linux/macOS):

curl --unix-socket "$XDG_RUNTIME_DIR/endara-relay/api.sock" http://localhost/api/status

---

All tests (including integration tests)

cargo test --all-targets ```

---