MCP (внешние инструменты)

MCP (внешние инструменты)

zames может использовать инструменты с серверов MCP. Главный пример — @playwright/mcp: он даёт агенту настоящий браузер (navigate, click, snapshot, type, …) поверх того, который zames уже использует для чата DeepSeek, Qwen или GLM.

Положите файл конфига (той же формы, что в Claude Code / Cursor):

• ~/.zames/mcp.json — глобальный
• <project>/.zames/mcp.json — на уровне проекта (поздние файлы побеждают)
• <project>/.mcp.json — привычное имя MCP

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--headless", "--isolated"]
    }
  }
}

ВАЖНО: держите MCP-браузер изолированным. @playwright/mcp по умолчанию использует ТУ ЖЕ директорию профиля, что и zames (~/.zames/profile). Если запустить его без –isolated (или без собственного –user-data-dir), MCP-браузер и браузер агента подерутся за один профиль, и чат DeepSeek покажет «Something went wrong when opening your profile». Всегда передавайте –isolated, как в примере выше. Серверы бывают и удалёнными (“url”: “https://…”, “transport”: “sse”). Их инструменты видны агенту как server__tool (например, playwright__browser_navigate) и перечисляются в /mcp и /status. Сервер, который не смог подключиться, пропускается с предупреждением и никогда не роняет агента.

Рекомендованные серверы (проверены)

Несколько небольших полезных серверов, протестированных вживую с zames (на бэкендах DeepSeek, Qwen и GLM):

• Context7 (@upstash/context7-mcp) — подтягивает АКТУАЛЬНУЮ документацию библиотеки (для конкретной версии) до того, как агент пишет код, вместо устаревших знаний из обучения. Инструменты: resolve_library_id, затем query_docs. Проверено вживую на DeepSeek и Qwen (слой MCP не зависит от провайдера, поэтому работает и с GLM): агент вызвал оба инструмента и получил актуальный API Zod. Именно его стоит подключить первым.

  {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
  

• Sequential Thinking (@modelcontextprotocol/server-sequential-thinking) — один инструмент sequentialthinking, дающий модели явный пересматриваемый план перед действием; полезно для длинных многошаговых задач.

• Memory (@modelcontextprotocol/server-memory) — локальный граф знаний (9 инструментов) для долговременных фактов между чатами. ВНИМАНИЕ: у zames уже есть MEMORY.md + AGENTS.md; подключайте, только если нужен граф с запросами.

Держите набор МАЛЕНЬКИМ: каждый сервер грузит описания своих инструментов в контекст модели. Добавляйте, когда почувствовали нехватку, а не заранее.