Emacs MCP Server

Emacs MCP サーバー

Emacs 用の Model Context Protocol（MCP）サーバーです。実行中の Emacs プロセスで elisp コードを生成して実行できます。

ツール

サーバーは 2 つのツールを公開します。

• generate_emacs_lisp_code：指定されたタスクの elisp コードを生成します
• execute_emacs_lisp_code：実行中の Emacs に（emacsclient 経由で）elisp を渡し、評価して実行します。

起動方法

このプロジェクトは uv で管理されています。まず、uv sync を実行してすべての依存関係をインストールします。次に、source .venv/bin/activate を実行して作成された venv を有効にします。

Inspector で MCP サーバーを実行するには：

mcp dev emacs_mcp_server.py

Claude Desktop で使用できるように MCP サーバーをインストールするには：

mcp install emacs_mcp_server.py

ただし、生成された 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"
      }
    }