feat(mcp): add slash command listing

tests/test_mcp_commands.py

@@ -0,0 +1,89 @@
+"""Tests for /mcp slash command integration."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from unittest.mock import AsyncMock, MagicMock, patch
+
+import pytest
+
+from nanobot.bus.events import InboundMessage
+
+
+class _FakeTool:
+    def __init__(self, name: str) -> None:
+        self._name = name
+
+    @property
+    def name(self) -> str:
+        return self._name
+
+    @property
+    def description(self) -> str:
+        return self._name
+
+    @property
+    def parameters(self) -> dict:
+        return {"type": "object", "properties": {}}
+
+    async def execute(self, **kwargs) -> str:
+        return ""
+
+
+def _make_loop(workspace: Path, *, mcp_servers: dict | None = None):
+    """Create an AgentLoop with a real workspace and lightweight mocks."""
+    from nanobot.agent.loop import AgentLoop
+    from nanobot.bus.queue import MessageBus
+
+    bus = MessageBus()
+    provider = MagicMock()
+    provider.get_default_model.return_value = "test-model"
+
+    with patch("nanobot.agent.loop.SubagentManager"):
+        loop = AgentLoop(bus=bus, provider=provider, workspace=workspace, mcp_servers=mcp_servers)
+    return loop
+
+
+@pytest.mark.asyncio
+async def test_mcp_lists_configured_servers_and_tools(tmp_path: Path) -> None:
+    loop = _make_loop(tmp_path, mcp_servers={"docs": object(), "search": object()})
+    loop.tools.register(_FakeTool("mcp_docs_lookup"))
+    loop.tools.register(_FakeTool("mcp_search_web"))
+    loop.tools.register(_FakeTool("read_file"))
+
+    with patch.object(loop, "_connect_mcp", AsyncMock()) as connect_mcp:
+        response = await loop._process_message(
+            InboundMessage(channel="cli", sender_id="user", chat_id="direct", content="/mcp")
+        )
+
+    assert response is not None
+    assert "Configured MCP servers:" in response.content
+    assert "- docs" in response.content
+    assert "- search" in response.content
+    assert "docs: lookup" in response.content
+    assert "search: web" in response.content
+    connect_mcp.assert_awaited_once()
+
+
+@pytest.mark.asyncio
+async def test_mcp_without_servers_returns_guidance(tmp_path: Path) -> None:
+    loop = _make_loop(tmp_path)
+
+    response = await loop._process_message(
+        InboundMessage(channel="cli", sender_id="user", chat_id="direct", content="/mcp list")
+    )
+
+    assert response is not None
+    assert response.content == "No MCP servers are configured for this agent."
+
+
+@pytest.mark.asyncio
+async def test_help_includes_mcp_command(tmp_path: Path) -> None:
+    loop = _make_loop(tmp_path)
+
+    response = await loop._process_message(
+        InboundMessage(channel="cli", sender_id="user", chat_id="direct", content="/help")
+    )
+
+    assert response is not None
+    assert "/mcp [list]" in response.content

tests/test_telegram_channel.py

@@ -1,5 +1,3 @@
-import asyncio
-from pathlib import Path
 from types import SimpleNamespace
 from unittest.mock import AsyncMock
 
@@ -206,6 +204,13 @@ def test_is_allowed_rejects_invalid_legacy_telegram_sender_shapes() -> None:
     assert channel.is_allowed("not-a-number|alice") is False
 
 
+def test_build_bot_commands_includes_mcp() -> None:
+    commands = TelegramChannel._build_bot_commands("en")
+    descriptions = {command.command: command.description for command in commands}
+
+    assert descriptions["mcp"] == "List MCP servers and tools"
+
+
 @pytest.mark.asyncio
 async def test_send_progress_keeps_message_in_topic() -> None:
     config = TelegramConfig(enabled=True, token="123:abc", allow_from=["*"])