Emacs MCP

🚀 Emacs MCP - Emacs用モデルコンテキストプロトコル

このパッケージは、Emacs用のモデルコンテキストプロトコル（MCP）を実装しており、大規模言語モデル（LLMs）がEmacsの環境や設定に関する情報にアクセスする機能を拡張します。Emacs MCPは、読み込まれたパッケージ、利用可能な関数、キーバインディング、ドキュメントなどの情報をツールに提供します。これにより、ユーザーが手動で関連するファイルを指定することなく、LLMsを使用してEmacsの設定を拡張したり、新しいパッケージを作成したりすることが可能になります。

🚀 クイックスタート

Emacs MCPは、Emacs環境の情報をLLMsに提供することで、Emacsの設定拡張や新パッケージ作成を支援します。以下に、インストール方法と使用例を紹介します。

✨ 主な機能

• Emacs環境や設定に関する情報をLLMsに提供
• 読み込まれたパッケージ、利用可能な関数、キーバインディング、ドキュメントなどの情報を取得
• ユーザーが手動で関連ファイルを指定することなく、LLMsを使用してEmacsの設定を拡張したり新しいパッケージを作成したりできる

📦 インストール

このリポジトリをクローンし、ユーザーの初期化ファイル（例: ~/.emacs.d/init.el または同等のファイル）に以下のコードを追加します。

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

モデルコンテキストプロトコルインスペクターを使用して設定をテストします。

npx @modelcontextprotocol/inspector emacs --batch --load '<path to your init file>' --eval '(emacs-mcp-run-stdio)'

Doom Emacsの設定

Doom Emacsには初期化ファイルがありません。バッチモードで実行する前にユーザー設定を読み込むには、Doom Emacs環境をブートストラップし、設定ファイルを読み込むdoomscriptファイルを作成する必要があります。

以下の内容で ~/.config/doom/bin/emacs-mcp というファイルを作成できます。

#!/usr/bin/env doomscript
(defcli! emacs-mcp ()
  (doom-modules-initialize)      ; モジュールシステムを初期化
  (doom-initialize t)            ; 対話型セッションのようにDoomをブートストラップ
  (doom-startup)                 ; モジュールとユーザー設定を読み込む
  (emacs-mcp-run-stdio))         ; MCPサーバーを実行

(run! "emacs-mcp")

これにより、MCPサーバーを実行するEmacsインスタンスが、対話型のDoom Emacsインスタンスと同じ環境とモジュールにアクセスできるようになります。

次に、以下のコマンドを使用して設定をテストできます。

npx @modelcontextprotocol/inspector ~/.config/emacs/bin/doomscript ~/.config/doom/bin/emacs-mcp

💻 使用例

基本的な使用法

LLMクライアントのドキュメントに従って mcp.json ファイルを変更することで、LLMクライアント用にMCPサーバーを設定します。例えば、Claude Code や Amazon Q Developer CLI のドキュメントを参照してください。

{
  "mcpServers": {
    "emacs": {
      "command": "emacs",
      "args": [
        "--batch",
        "--load",
        "<path to your init file>",
        "--eval",
        "(emacs-mcp-run-stdio)"
      ]
    }
  }
}

高度な使用法

Doom Emacsを使用している場合は、以下の設定を使用できます。

{
  "mcpServers": {
    "emacs": {
      "command": "~/.config/emacs/bin/doomscript",
      "args": ["~/.config/doom/bin/emacs-mcp"]
    }
  }
}

📄 ライセンス

MIT