clojure-mcp

clojure-mcp — MCP-сервер сообщества (автор — bhauman). Инструменты разработки на Clojure с доступом к работающей программе через REPL. Лицензия EPL-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
bhauman
Лицензия
EPL-2.0
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
clojure

Уровень риска: high

clojure_eval выполняет произвольный код в процессе приложения; не подключать к рабочему REPL.

Настройка клиентов

codex
{
    "code": "# OpenAI Codex\ncodex mcp add clojure-mcp -- clojure -Tmcp start :config-profile :repl",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

ClojureMCP подключает агента к запущенному nREPL в вашем проекте на Clojure. Агент работает так же, как программист на Clojure: исследует код в REPL, проверяет предположения на живой программе и тестирует изменения по ходу работы.

Рекомендуемая конфигурация — профиль :repl — даёт три инструмента:

  • clojure_eval выполняет код через постоянное соединение с nREPL и перед выполнением исправляет несбалансированные скобки. Работает с Clojure, ClojureScript (shadow-cljs, Figwheel), Babashka, Basilisp и Scittle;
  • list_nrepl_ports находит nREPL-серверы, запущенные на машине, чтобы агент мог переключаться между ними, например между Clojure и shadow-cljs;
  • paren_repair — страховка на редкий случай, когда скобки сложно распутать обычным редактированием строк.

Чтение и редактирование файлов, поиск и оболочка остаются у самого агента. Соединение постоянное: состояние, накопленное в REPL, сохраняется между вычислениями.

Полный набор инструментов в режиме поддержки. Без профиля ClojureMCP отдаёт свой исходный полный набор: структурные редакторы, чтение файлов, файловые и shell-инструменты, субагенты. Он создавался для Claude Desktop, когда модели часто ломали скобки Clojure. По README, современные модели редактируют Clojure надёжно, поэтому эти инструменты в режиме поддержки и постепенно идут к выводу из употребления. Рекомендуется профиль :repl.

Кому подойдёт

  • Разработчикам на Clojure и ClojureScript, которые работают с Claude Code, Codex или Gemini CLI.
  • Тем, кто хочет, чтобы агент проверял код в живом REPL, а не только читал и правил исходники.

Другие серверы — в категории разработка.

Установка

Требования: Clojure, Java (JDK 17 или новее) и nREPL в проекте. ClojureMCP может и сам запустить nREPL через :start-nrepl-cmd или :fallback-nrepl.

clojure -Ttools install-latest :lib io.github.bhauman/clojure-mcp :as mcp

После этого команда clojure -Tmcp start доступна из любой папки.

Подключение к клиентам

Команды приведены дословно из README. Выполняйте их из папки проекта. Подробнее — в инструкции как подключить MCP.

# Claude Code
claude mcp add clojure-mcp -- clojure -Tmcp start :config-profile :repl

По умолчанию ClojureMCP подключается к порту из файла .nrepl-port в проекте. Если REPL не запущен, добавьте :fallback-nrepl true — тогда сервер поднимет его сам. Другой вариант — :start-nrepl-cmd '["clojure" "-M:nrepl"]' для своего алиаса. Настройка Claude Desktop описана в doc/full-toolkit.md репозитория.

Проверка

Запустите сервер из папки проекта:

clojure -Tmcp start :config-profile :repl

В выводе должны появиться строки JSON-RPC с уведомлениями notifications/tools/list_changed. После подключения попросите агента вычислить (+ 1 2) в REPL.

Примеры задач

Найди запущенные REPL и проверь в shadow-cljs, что функция format-price возвращает строку.
Загрузи изменённое пространство имён в REPL и прогони его тесты.

Риски

clojure_eval выполняет произвольный код в процессе вашего приложения с его правами и доступом к данным, файлам и сети. Состояние REPL сохраняется между вызовами. Не подключайте агента к REPL рабочего окружения. Профиль :cli-assist-agent использует субагента на LLM и требует API-ключ — храните его в переменной окружения. Варианты песочницы описаны в вики проекта.

Частые вопросы

Чем профиль :repl отличается от полного набора?

:repl даёт только REPL-инструменты, а файлы и оболочку оставляет агенту. Полный набор добавляет свои редакторы и файловые инструменты, но он в режиме поддержки.

Можно ли обойтись без MCP-сервера?

Да, README предлагает clojure-mcp-light: это nREPL-клиент для оболочки и хук для починки скобок.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Everything

Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники