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的完整路徑準確無誤，否則可能導致服務器無法正常運行。