Emacs MCP Server

🚀 Emacs MCP 服务器

Emacs MCP 服务器基于模型上下文协议（MCP），专为 Emacs 打造。它能够生成 Elisp 代码，并在运行中的 Emacs 进程里执行这些代码，为开发者提供了便捷的代码生成与执行能力。

✨ 主要特性

该服务器公开了两个实用工具：

• generate_emacs_lisp_code：可针对给定任务生成对应的 Elisp 代码。
• execute_emacs_lisp_code：借助emacsclient，将 Elisp 代码传递到正在运行的 Emacs 中进行评估和执行。

📦 安装指南

此项目使用uv进行管理，安装步骤如下：

1. 运行uv sync，安装所有依赖项。
2. 执行source .venv/bin/activate，激活生成的虚拟环境。

💻 使用示例

基础用法

在检查器中运行 MCP 服务器

mcp dev emacs_mcp_server.py

将 MCP 服务器安装为 Claude Desktop 可用

mcp install emacs_mcp_server.py

高级用法

安装为 Claude Desktop 可用后，你必须编辑生成的 JSON 配置文件claude_desktop_config.json，使其包含 API 密钥和emacsclient的完整路径。配置文件示例如下：

{
    "Emacs-MCP-Server": {
      "command": "/Users/haldar/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "smartfunc",
        "mcp",
        "run",
        "/Users/haldar/repos/gh/emacs-mcp-server/emacs_mcp_server.py"
      ],
      "env": {
          "OPENAI_API_KEY": "sk-xxxx",
          "EMACSCLIENT": "/your/path/to/emacsclient"
      }
    }
}

⚠️ 重要提示

编辑claude_desktop_config.json文件时，要确保 API 密钥和emacsclient的完整路径准确无误，否则可能导致服务器无法正常运行。