Подключайте большие языковые модели напрямую к вашей среде Emacs! Этот сервер MCP (Model Context Protocol) предоставляет функциональность Emacs с помощью стандартизированных инструментов, позволяя LLM, таким как Claude, читать и изменять ваши буферы, выполнять elisp-код, навигацию по файлам и многое другое.

Быстрый старт

Установка: Поместите файлы в каталог конфигурации Emacs и добавьте в конфигурацию:

Альтернативно используйте менеджеры пакетов:

Запустить сервер: Запустить M-x mcp-server-start-unix в Emacs. Сервер создаёт Unix-сокет в ~/.config/emacs/.local/cache/emacs-mcp-server.sock.

Подключите Claude Desktop: Добавьте это в конфигурацию Claude Desktop:

[! ПРИМЕЧАНИЕ] Убедитесь, что у вас установлен socat!

Соединить Клода КЛИ

Клод теперь может взаимодействовать с вашей сессией Emacs.

Что могут делать LLM

После подключения LLM могут выполнять мощные операции в вашей среде Emacs:

Манипуляция кодом и текстом

• Читать и записывать любой буфер — получать содержимое из файлов, скретч-буферов, терминалов
• Выполнить elisp-код — безопасно запустить любое выражение Lisp Emacs
• Навигация и редактирование — перемещение курсора, вставка текста, выбор регионов
• Управление файлами — открытие, сохранение, создание новых файлов и буферов

MCP Server for Emacs

Connect Large Language Models directly to your Emacs environment! This MCP (Model Context Protocol) server exposes Emacs functionality through standardized tools, allowing LLMs like Claude to read and modify your buffers, execute elisp code, navigate files, and much more.

Quick Start

Installation: Place the files in your Emacs configuration directory and add to your config:

(add-to-list 'load-path "~/path-to/mcp-server")
(require 'mcp-server)

Alternatively, use package managers:

;; Using straight.el
(use-package mcp-server
  :straight (:type git :host github :repo "rhblind/emacs-mcp-server"
             :files ("*.el" "tools/*.el" "mcp-wrapper.py" "mcp-wrapper.sh"))
  :config
  (add-hook 'emacs-startup-hook #'mcp-server-start-unix))

;; Using use-package with manual path
(use-package mcp-server
  :load-path "~/path-to/mcp-server"
  :config
  (add-hook 'emacs-startup-hook #'mcp-server-start-unix))

;; Using Doom Emacs package! macro
(package! mcp-server
  :recipe (:type git :host github :repo "rhblind/emacs-mcp-server"
           :files ("*.el" "tools/*.el" "mcp-wrapper.py" "mcp-wrapper.sh")))

Start the server: Run M-x mcp-server-start-unix in Emacs. The server creates a Unix socket at ~/.config/emacs/.local/cache/emacs-mcp-server.sock.

Connect Claude Desktop: Add this to your Claude Desktop configuration:

[!NOTE] Make sure you have socat installed!

{
  "mcpServers": {
    "emacs": {
      "command": "socat",
      "args": ["-", "UNIX-CONNECT:~/.config/emacs/.local/cache/emacs-mcp-server.sock"],
      "transport": "stdio"
    }
  }
}

Connect Claude CLI

claude mcp add emacs -- socat - UNIX-CONNECT:$HOME/.config/emacs/.local/cache/emacs-mcp-server.sock  # Uses socat directly
claude mcp add emacs ~/path-to/mcp-wrapper.py ~/.config/emacs/.local/cache/emacs-mcp-server.sock     # Uses the python wrapper script
claude mcp add emacs ~/path-to/mcp-wrapper.sh ~/.config/emacs/.local/cache/emacs-mcp-server.sock     # Uses the bash wrapper script

# Optionally, add to user scope so it's always available
claude mcp add emacs --scope user -- socat - UNIX-CONNECT:$HOME/.config/emacs/.local/cache/emacs-mcp-server.sock

Claude can now interact with your Emacs session.

What LLMs Can Do

Once connected, LLMs can perform powerful operations in your Emacs environment: