Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
"""``/api/mcp*`` against the real owner runtime and stdio fixture."""
import json
import sys
from pathlib import Path
import pytest
from core.mcp_hub import repository
from core.mcp_hub.runtime import McpRuntime
from tests.ui_server_test_helpers import csrf_headers, save_config
from vibe import internal_client
from vibe.authorization import http_authorization_policy
from vibe.ui_server import app
FIXTURE = str(Path(__file__).parent / "fixtures" / "mcp_echo_server.py")
PASTE = json.dumps({"mcpServers": {"echo": {
"command": sys.executable, "args": [FIXTURE], "env": {"ECHO_TOKEN": "s3cret-value"}}}})
@pytest.fixture
def owner(monkeypatch, tmp_path):
config = save_config(tmp_path)
config.runtime.default_cwd = str(tmp_path)
config.save()
runtime = McpRuntime()
async def forward(operation, payload, **_kwargs):
status, body = await runtime.submit(operation, payload)
assert status == 200
return json.loads(body)
monkeypatch.setattr(internal_client, "mcp_request", forward)
yield runtime
runtime.stop()
def test_add_registers_and_delete_removes_through_the_api(owner):
client = app.test_client()
headers = csrf_headers(client)
added = client.post("/api/mcp", json={"text": PASTE}, headers=headers)
body = added.get_json()
assert added.status_code == 200 and body["ok"] and body["toolCount"] == 7
assert "s3cret-value" not in added.text
assert repository.read_avibe_definition("echo") is not None
listed = client.get("/api/mcp").get_json()["servers"]
assert listed[0]["name"] == "echo" and listed[0]["source"] == "avibe"
owner.stop()
detail = client.get("/api/mcp/echo").get_json()
assert detail["server"]["name"] == "echo"
assert "s3cret-value" not in json.dumps(detail)
assert any(tool["name"] == "echo" for tool in detail.get("tools") or detail["server"].get("tools") or [])
assert client.delete("/api/mcp/echo", headers=headers).get_json()["removed"] is True
assert client.get("/api/mcp/echo").status_code == 404
def test_all_failed_batch_returns_per_server_reasons_and_identical_readd_is_unchanged(owner):
client = app.test_client()
headers = csrf_headers(client)
first = client.post("/api/mcp", json={"text": PASTE}, headers=headers)
assert first.status_code == 200 and first.get_json()["ok"]
again = client.post("/api/mcp", json={"text": PASTE}, headers=headers)
body = again.get_json()
assert again.status_code == 200
assert body["ok"] is True
assert body["unchanged"][0]["name"] == "echo"
assert body["failed"] == []
assert body["added"] == []
batch = {
"mcpServers": {
"echo": {"command": sys.executable, "args": [FIXTURE], "env": {"ECHO_TOKEN": "s3cret-value"}},
"github": {"command": "/nonexistent/mcp-github"},
"other": {"command": "/nonexistent/mcp-other"},
}
}
failed = client.post("/api/mcp", json={"text": json.dumps(batch)}, headers=headers)
payload = failed.get_json()
assert failed.status_code == 200
assert payload["ok"] is True # echo is unchanged
names = {item["name"]: item for item in payload["failed"]}
assert "github" in names and names["github"]["error"]
assert "other" in names
assert payload["unchanged"][0]["name"] == "echo"
assert payload.get("error", {}).get("message") or names["github"]["error"]
empty_fail = {
"mcpServers": {
"github": {"command": "/nonexistent/mcp-github"},
"other": {"command": "/nonexistent/mcp-other"},
}
}
none = client.post("/api/mcp", json={"text": json.dumps(empty_fail)}, headers=headers)
none_body = none.get_json()
assert none.status_code == 200
assert none_body["ok"] is False
assert {item["name"] for item in none_body["failed"]} == {"github", "other"}
assert none_body["error"]["message"]
assert "Unexpected MCP Hub response" not in json.dumps(none_body)
def test_needs_login_package_lists_and_details_without_500(owner):
definition = {
"name": "suno",
"transport": {"type": "http", "url": "https://api.example/mcp"},
}
repository.write_definition(definition)
repository.publish(
"suno",
definition=definition,
manifest={"description": "", "auth": "needs_login"},
tools=[],
commands=[],
)
client = app.test_client()
listed = client.get("/api/mcp")
assert listed.status_code == 200
body = listed.get_json()
assert body["ok"] is True
assert body["servers"][0]["auth"] == "needs_login"
detail = client.get("/api/mcp/suno")
assert detail.status_code == 200
payload = detail.get_json()
assert payload["ok"] is True
assert payload["server"]["auth"] == "needs_login"
assert payload.get("tools") == []
def test_mcp_run_wraps_unexpected_errors_as_internal_object():
from vibe import mcp_api
async def boom():
raise RuntimeError("disk full")
body, status = __import__("asyncio").run(mcp_api.run(boom))
assert status == 500
assert body["ok"] is False
assert body["error"]["type"] == "internal"
assert "disk full" in body["error"]["message"]
def test_malformed_json_add_returns_top_level_error_without_batch_arrays(owner):
client = app.test_client()
headers = csrf_headers(client)
response = client.post("/api/mcp", json={"text": "{not json"}, headers=headers)
body = response.get_json()
assert response.status_code == 400
assert body["ok"] is False
assert body.get("error", {}).get("message")
assert "added" not in body
assert "failed" not in body
@pytest.mark.parametrize(
("method", "path", "role"),
[
("GET", "/api/mcp", "editor"),
("GET", "/api/mcp/echo", "editor"),
("GET", "/api/mcp/oauth/callback", "viewer"),
("POST", "/api/mcp", "owner"),
("POST", "/api/mcp/discover", "owner"),
("POST", "/api/mcp/echo/refresh", "owner"),
("DELETE", "/api/mcp/echo", "owner"),
("GET", "/api/mcp/echo/oauth/start", "owner"),
("POST", "/api/mcp/echo/oauth/complete", "owner"),
("POST", "/api/mcp/echo/oauth/logout", "owner"),
],
)
def test_route_roles(method, path, role):
assert http_authorization_policy(method, path).minimum_role == role
@pytest.fixture
def oauth_server(owner):
from tests.test_mcp_hub_oauth import _LoopbackOauth
server = _LoopbackOauth()
server.start()
try:
status, _ = __import__("asyncio").run(
owner.submit("add", {"servers": [{"name": "suno", "server": {"url": f"{server.origin}/mcp"}}]})
)
assert status == 200
yield server
finally:
server.stop()
@pytest.mark.parametrize("fetch_site", ["same-origin", "none"])
def test_oauth_start_link_redirects_to_authorize_url(owner, oauth_server, fetch_site):
response = app.test_client().get("/api/mcp/suno/oauth/start", headers={"Sec-Fetch-Site": fetch_site})
assert response.status_code == 302
assert response.headers["Location"].startswith(f"{oauth_server.origin}/authorize?")
assert len(owner._pending_logins) == 1
@pytest.mark.parametrize("fetch_site", ["cross-site", "same-site"])
def test_oauth_start_link_rejects_cross_site_without_pending_login(owner, oauth_server, fetch_site):
response = app.test_client().get("/api/mcp/suno/oauth/start", headers={"Sec-Fetch-Site": fetch_site})
assert response.status_code == 403
assert response.headers["Content-Type"].startswith("text/html")
assert owner._pending_logins == {}
def test_oauth_start_link_allows_missing_fetch_site_with_same_origin_referer(owner, oauth_server):
response = app.test_client().get(
"/api/mcp/suno/oauth/start",
headers={"Referer": "http://127.0.0.1/skills"},
)
assert response.status_code == 302
assert len(owner._pending_logins) == 1
def test_oauth_start_link_rejects_missing_fetch_site_without_same_origin_referer(owner, oauth_server):
foreign = app.test_client().get(
"/api/mcp/suno/oauth/start",
headers={"Referer": "https://evil.example/skills"},
)
assert foreign.status_code == 403
assert owner._pending_logins == {}
missing = app.test_client().get("/api/mcp/suno/oauth/start")
assert missing.status_code == 403
assert owner._pending_logins == {}
scheme_mismatch = app.test_client().get(
"/api/mcp/suno/oauth/start",
headers={"Referer": "https://127.0.0.1/skills"},
)
assert scheme_mismatch.status_code == 403
assert owner._pending_logins == {}
def test_list_reports_oauth_mode_for_request_origin(owner):
from vibe import mcp_api
assert app.test_client().get("/api/mcp").get_json()["oauthMode"] == "direct"
modes = {
origin: __import__("asyncio").run(mcp_api.list_servers(origin, 5123))["oauthMode"]
for origin in ("http://127.0.0.1:5123", "https://avibe.example", "http://192.168.1.20:5123")
}
assert modes == {
"http://127.0.0.1:5123": "direct",
"https://avibe.example": "direct",
"http://192.168.1.20:5123": "paste",
}
def test_oauth_start_unknown_server_renders_html_error(owner):
response = app.test_client().get("/api/mcp/missing/oauth/start", headers={"Sec-Fetch-Site": "same-origin"})
assert response.status_code == 400
assert response.headers["Content-Type"].startswith("text/html")
assert owner._pending_logins == {}