Emacs on かおるのブログ

gpt.el & mcp.el で整う emacs llm環境

Wed, 02 Jul 2025 11:16:00 +0900

はじめに

Emacs内での大規模言語モデル（LLM）との連携は、ここ数年で劇的な進化を遂げてきました。

私の最初のEmacs 内LLMとの出会いは2022年11月、copilot.el によるAI 自動補完でした。このときの感動は鮮明に覚えています。

その後間もなくChatGPT が登場し、ChatGPT.el 等でEmacs内でのAIとの対話ができるようになりましたが、当時は機能も少なく、EmacsでLLMを使うメリットはあまり感じられませんでした。

自分的ブレークスルーは、東京Emacs勉強会サマーフェスティバル2024 のTomoya さんの発表で ellama を知ったことでした。 ellamaでは従来の対話形式だけでなく、様々な関数を通じてLLMを利用でき、Emacs が何倍も強力な開発環境へと変貌しました。

そして最近では gptel が llm module として doom emacs に正式に組み込まれ、ツール連携やプロンプト/コンテクストエンジニアリング¹が非常にスムーズになりました。

これとmcp.el と組み合わせることで、LLM in emacs がある種のplateau に達したのではと感じている今、これを知らないEmacser (同胞) がもしいたら非常に勿体ないと思うので、この記事を書くことにしました。

gptel, mcp.el の設定方法や使う理由、ユースケースなどを紹介します。

  gantt
    title 私のEmacs 内LLM 遍歴
    todayMarker off
    dateFormat YYYY-MM
    axisFormat %Y-%m
    section 自動補完
        copilot.el :2022-11, 32M
    section 黎明期
        ChatGPT.el :2023-03, 17M
        org-ai :2023-12, 8M
    section 革命
        ellama/llm              :2024-08, 9M
    section 開拓期
        ai-org-chat :2024-11, 2M
        ob-llm :2025-01, 2M
        elisa :2025-03, 1M
        copilot-chat.el     :2025-03, 2M
    section 成熟期
        gptel+mcp.el              :2025-05, 2M
        claude-code.el              :2025-06, 1M

`gptel` とは

gptelは、Emacsのためのシンプルかつ強力な大規模言語モデル（LLM）クライアントです。 Emacs内のあらゆる場所から自由な形式でLLMと対話できる環境を提供します。このデモを見ると使用イメージが分かりやすいです。

NixOSのエラー: Could not start dynamically linked executable の対処法についてのメモ

Wed, 02 Jul 2025 11:16:00 +0900

別記事 gpt.el & mcp.el で整う emacs llm環境 -> mcp.el の設定例にあるようにmcp.el で使ういくつかの mcp server の起動で uvx を使用しているのですが、nixOS で最初に起動したときにエラーが出てしまいました。解決方法と原因を Gemini に調べさせたので、メモしておきます。

症状とエラーメッセージ

*Mcp-Hub* buffer で mcp-hub-view-log を確認すると、以下のエラーが出ていました:

[stderr]  Could not start dynamically linked executable: /home/bk/.cache/uv/archive-v0/unI5q9QapqXHm9fPXna4G/bin/python
[stderr]  NixOS cannot run dynamically linked executables intended for generic
[stderr]  linux environments out of the box. For more information, see:
[stderr]  https://nix.dev/permalink/stub-ld
[jsonrpc] D[14:56:49.461] Connection state change: `exited abnormally with code 127

解決策：nix-ld を有効にする

nix conifguration で、以下を足したら直りました。

ox-hugo で mermaid.js を使う方法

Sat, 21 Jun 2025 22:07:00 +0900

はじめに

このブログは、以下のワークフローで運用されています。

  graph LR
  org-mode -- <a href="https://ox-hugo.scripter.co/">ox-hugo</a> --> markdown -- <a href="https://gohugo.io/">Hugo</a> --> HTML

上のようなフローチャートなどのダイアグラムを載せようとすると、どのような方法が思い浮かぶでしょうか？

まさか、パワポ等で作ったダイアグラムを画像としてエクスポートして…なんて方法は考えていませんよね？

それ、Dティアです

図1: パワポはまじでDティア

それはさておき、私はダイアグラムを作る方法について詳しくなかったので、ox-hugo を使うという前提で Gemini 2.5 Pro に、Deep research してもらいました。結果、以下のようなTier Listができました。¹

表 1: ox-hugo でのダイアグラム作成方法のTier List by Gemini 2.5 Pro & me

HugoレンダーフックによるMermaid.js

Org Babel + Hugo Kroki

純粋なOrg Babel実行 (PlantUML/Ditaa)

GUIツール (Excalidraw等) で作成し、SVG/PNG画像として挿入

レガシーなHugoショートコード

iFrame埋め込み

アスキーアート (ditaa, GoAT)

🤮 M社製品 (PowerPoint, Visio)で作成+バイナリ挿入 🤮

表で示しているように、個人的にはmermaid.js を使うのがベストです。しかし、方法がそれほどシンプルではなく、少し面倒だったので、書き残しておきます。

Doom Emacs & Mac へのSKK導入ガイド

Sat, 12 Apr 2025 13:52:00 +0900

この記事で分かること

SKKとは何か
AquaSKKのインストールと設定方法
Doom EmacsでのSKK（ddskk）の導入方法
SKK導入における障壁とその解決方法
SKKを長期間使用した感想と評価

SKKとは

SKK（Simple Kana to Kanji conversion program）は、日本語入力システムの一種です。一般的なIMEとは異なり、入力モードの切り替えが明示的で、変換候補を選ぶ際にも独特の操作方法を持っています。特徴として：

変換時に送り仮名を明示的に指定する
辞書が自己学習し、使うほど自分専用の辞書になっていく
キーボードから手を離さずに日本語入力ができる

が挙げられます。

SKKとわたし

昨年8月に参加した東京Emacs勉強会サマーフェスティバル2024 でSKKの存在を知り、そこでSKKをちょっと使ってみるも、何が良いのかわからず、いつのまにか存在を忘れる
約2ヶ月後の東京Emacs勉強会オクトーバーフェスティバル2024 で再度SKKの話題になる。参加者の過半数がSKKを使用しており、その空間ではSKKを使っていない方がマイノリティであることを知り、すぐにSKKを導入。全然思うように使えず、生産性が爆下がりする
しかし、日本のEmacser多くの方々が使っているからには、何かしら良いところがあるはずだと考え、キーボード自体の設定を変えたりしながら、徐々にSKKに適応していく
使い始めてから5ヶ月ほど経ち、SKK関連の設定も安定。試行錯誤の結果の設定を共有したいと思いこの記事を書くに至る

AquaSKKの導入

インストール

Homebrewを使って簡単にインストールできます：
```
brew install --cask aquaskk
```
です。

nix&flake&home-managerを使っている方は、以下を適切にimportするとインストールできます：
```
homebrew.casks = [
  "aquaskk"
];
```

基本設定

こういうのは基本的にデフォルトのままで使いたい派の自分ですが、日本語入力の切り替えキーだけは変えました。

AquaSKK/keymap.conf:
```
- SKK_JMODE		ctrl::j
+ SKK_JMODE		ctrl::shift::j
```
（理由は後述します）

設定の同期

複数のデバイス間で辞書やキーマップの設定を同期させるために、AquaSKKのディレクトリをDropboxに配置し、 ~/Library/Application Support/ 内にシンボリックリンクを作成しました：
```
ln -s ~/Dropbox/AquaSKK ~/Library/Application\ Support/AquaSKK
```

Macのデフォルト入力切替キー無効化

最強のAnki用単語学習Cardを作った

Mon, 17 Mar 2025 10:30:00 +0900

はじめに

皆さん、Ankiは使っていますか？ Ankiは、間隔反復学習システム(SRS)を採用した、非常に強力な暗記ツールです。私も長年Ankiを愛用しており、特に語学学習には欠かせない存在となっています。

今回、私がAnkiで英語の語彙学習をするにあたり、「こんな機能があったら最高なのに…」と思う理想のカードタイプを形にし、 GitHubで公開しました。この記事では、そのカードタイプ「Super Vocab」の紹介と、開発の経緯、そしてAnki/Emacsユーザーには嬉しい、 anki-editor を使ったカード作成方法について解説します。

理想の単語カードに求める機能

私が単語学習用のフラッシュカードに求める機能は、以下の5点です。

双方向学習: 単語を見て意味を答えるだけでなく、意味を見て単語を答える、両方向の学習ができること。
意味→単語カードでの例文表示: 意味から単語を答えるカードでは、定義だけでなく、例文や用例も表示すること。
- 理由：
  - 単語は例文や構文とセットで覚えることで、記憶に定着しやすくなる。
  - 同義語の微妙なニュアンスの違いを理解し、区別して覚えられる。
- ただし、例文中のターゲット単語は隠したい (ここがポイント！)
  - 理由：答えが見えてしまうとフラッシュカードの意味がないからカードの意味がないから。
単語→意味はシンプルに: 単語から意味を答えるカードでは、単語以外の情報は極力表示しないこと。
- 理由: 例文などがあると、単語の意味を推測できてしまい、フラッシュカード本来の目的（想起訓練）が損なわれるため。
簡単に単語を追加でき、経験と結びつけられる: 読書などで出会った単語を、その文脈（例文）ごと簡単にカードに追加できること。
- 理由: 自分の経験と単語を結びつけることで、より深く記憶に刻み込むため。
柔軟な情報追加: 発音記号、品詞、関連語、語源、メモ、ヒント画像など、単語に関するあらゆる情報を簡単に追加できること。

既存のカードとの比較、そしてSuper Vocab誕生へ

AnkiWebを探しても、上記の機能を全て満たすカードタイプは見つかりませんでした。特に、2番目と3番目の要件（文脈付きの意味→単語カードで、ターゲット単語を自動的に隠す）を満たすものは皆無でした。

Ankiの標準機能であるクローズ削除（穴埋め問題）を使えば、この要件に近いものは作れます。しかし、例文が増えるほど手作業でのクローズ削除は大変です。

「JavaScriptなどを使って、自動的に単語を隠せないか？」

そう考えていた時、English vocab (note type) という素晴らしいカードタイプに出会いました。このカードタイプは、まさに私が求めていた自動クローズ削除機能を備えていました！しかし、惜しいことに、上記の要件を全て満たしているわけではありません。

そこで、私はこの「English vocab (note type)」をベースに、自分の理想とする機能を全て盛り込んだ、究極の単語カード「Super Vocab」を作ることにしました。

anki-editorとEmacs、立ちはだかる壁、そしてPull Requestへ

私は普段、Ankiのカード作成にanki-editorというEmacs packageを使っています。 org-modeで構造化されたノートをAnkiに簡単に取り込める、非常に便利なツールです。

Super Vocabのカードタイプも、anki-editorを使ってEmacsからAnkiに送信しようとしました。しかし、ここで問題が発生しました。

通常、anki-editorはorg-modeのノートをHTMLに変換してAnkiに送信します。しかし、HTMLに変換してしまうと、Super VocabのJavaScriptによる自動クローズ削除機能が動作しなくなってしまうのです。

anki-editorには :ANKI_FORMAT: nil というオプションがあり、これを使うとHTML変換を無効にできます。しかし、このオプションは全てのフィールドに適用されてしまい、カードの見た目（HTML/CSSによる装飾）も失われてしまいます。

「特定のフィールドだけ、HTML変換せずに生のテキストとしてAnkiに送りたい…」

しかし、anki-editorにはそのような機能はありませんでした。

emacs起動時の、 Project … cannot be read

Sun, 23 Feb 2025 18:41:00 +0900

問題

先日、いつものようにEmacsを起動すると、mini bufferに

Project <プロジェクト名> at <プロジェクトのパス> cannot be read.

と表示され、emacsがただの白い画面を写すソフトウェアになってしまいました。

少し前にこのプロジェクトのパスを変更したので、そのせいかと思い、 projectile-known-projects-file にあるプロジェクトのパスを変更/削除してみましたが、状況は変わりませんでした。 doom sync や doom upgrade なども試しても、解決しませんでした。

解決策

試行錯誤の結果、原因はなんと、treemacs にあることがわかりました。

treemacsは、セッション情報を、 treemacs-persist-file (通常は user-emacs-directory/.cache/treemacs-persist)に保存するのですが、その名の通り、treemacs_persistがpesistしていたのが原因だったようです。

そのため、

rm ~/.config/emacs/.cache/treemacs-persist # pathは環境によって異なる

で解決することができます。

自分はtreemacsを入れておきながら、全然使ってなかったので、treemacsをinitファイルから削除しました。

今回は以上です。

参考

Project .emacs.d at User/x.emacs.d cannot be read. · Issue #586 · Alexander-Miller/treemacs

Server julia-ls starting exited (check corresponding stderr buffer for details). Do you want to restart it? (y or n) の解決策

Wed, 29 Jan 2025 16:00:00 +0900

問題

先日久々にemacsでjuliaを使おうとしたら、

Server julia-ls:50759/starting exited (check corresponding stderr buffer for details). Do you want to restart it? (y or n)

のようなmessageが(y を押しても繰り返し)出てきて、lspが起動しませんでした。

これを直すのにそこそこ時間がかかったので、emacsでjuliaを使っている方 (果たして日本に何人いるのか…) のために解決策をメモしておきます。

解決策

lsp-julia のビルド済みファイルが格納されているディレクトリの中にある Project.toml (自分の環境では ~/.config/emacs/.local/straight/build-29.4/lsp-julia/languageserver/Project.toml ) が実体のあるファイルではなく、シンボリックリンクであることが原因でした。(理由はよくわからない)

そのため、シンボリックリンク先のファイル(自分の場合は /.config/emacs/.local/straight/repos/lsp-julia/languageserver/Project.toml)をコピーして、直接のファイルを同じ場所に作成することで解決しました。

参考

language server crashes · Issue #66 · gdkrmr/lsp-julia

『Pythonではじめる時系列分析入門』のorg version repoを作ったよ

Sun, 22 Dec 2024 08:37:00 +0900

最近、馬場真哉 (著) 『Pythonではじめる時系列分析入門』という本を読みました。

この本はpythonのコードを手で動かしながら時系列分析の基礎を学ぶことができる本で、とてもためになりました。

特にsktimeという、トレンド・季節性の除去などの前処理や予測モデルをsklearnのように簡単にpipeline化できるライブラリを知ることができた点がよかったです。

馬場先生はこの本の公式リポジトリを公開されているのですが、pythonコードがjupyter notebook形式で書かれているため、heavy emacserの私としてはどうしてもorg-modeを使いたくなってしまいました。

そこで、この本のコードをorg-mode形式に変換したリポジトリを作成しました。

リポジトリのリンク

このリポジトリを使って、emacsユーザーの方々がこの本を読む際に、jupyter notebookを使わずにorg-modeでコードを実行できるようになればと思います。

特にないと思いますが、このリポジトリを使って何か問題が発生した場合は、pull requestやissueを送っていただけると助かります。

時系列分析勉強中のemacsユーザーは私に感謝したうえで今年のクリスマスは家族と過ごしてください。

読んでいただきありがとうございました。

emacsをupgradeしたらankiの数式が汚くなったので直した

Sun, 24 Nov 2024 15:41:00 +0900

導入

こんにちは。私は日頃からanki-editor を使ってAnkiのカードを作成しているのですが、 Emacsをupgradeすると、数式が汚く表示されるようになってしまいました。

症状としては、

デスクトップ版のAnkiのBrowserで各Fieldのプレビューで数式が数式として表示されない (plain latex codeとして表示される)
数式がpng画像として表示される (もともとはMathJax inlineで表示されていた)

というものでした。

デスクトップ版のAnkiでcardを編集することはほぼないので、1の症状についてはまだ許容範囲でしたが、 2のほうについては、数式の解像度だけ低くなったり、他の文字とのサイズが合わなくなったりして、かなり気になりました。

解決策

以下を config.org に追加することで解決しました。

(use-package! anki-editor
  :after org
  :init
  (setq-default anki-editor-latex-style 'mathjax))

この解決策に至った背景

anki-editor でpushされたカードは、HTMLに変換された状態でカードとして保存されます。うまく数式が表示されるカードのHTMLを見ると、数式は以下のように anki-mathjax というタグで囲まれていました。

<anki-mathjax block="true">1 + 1 = 3</anki-mathjax>

一方、今回の問題が発生したカードのHTMLを見ると、数式は以下のように p タグと [$$] で囲まれていました。

<p>[$$] 1 + 1 = 3 [/$$]</p>

したがって、anki-editorがorgテキストをHTMLに変換する部分で、問題が発生していることがわかりました。 anki-editor.el の中を見てみると、以下のように anki-editor-latex-style という変数によって、latexのスタイルを変更できるようになっており、今回の解決策に至りました。

(defun anki-editor--translate-latex-env (latex-code)
  (setq latex-code (replace-regexp-in-string "\n" "<br>" (org-html-encode-plain-text latex-code)))
  (cl-ecase anki-editor-latex-style
    (builtin (concat "[latex]<br>" latex-code "[/latex]"))
    (mathjax (concat "\\[<br>" latex-code "\\]"))))

読んでいただきありがとうございました。

ox-htmlで\bmなどのlatexマクロを使う方法

Mon, 18 Nov 2024 16:35:00 +0900

問題

\bm{a}

上の数式を書いたorg fileは、latex(pdf)へのexportであれば \usepackage{bm} とセットで斜体太字になるところ、 ox-html で単にHTMLとして exportしただけではlatexマクロとして認識されなかったので、その対処法を解説します。

latexによる数式をHTML上で表示する場合、MathJaxというライブラリを使うことが一般的であり、今回の問題も \bm をMathJaxでマクロとして認識させることで解決できます。このQiita記事がまさにそれをやっていたので、それを参考にまず以下の方法を試してみました。

最初に試した方法

以下のブロックをorg fileに追加しました。

#+BEGIN_EXPORT html
<script>
    MathJax = {
        tex: {
            macros: {
                bm: ["\\boldsymbol{#1}", 1],
            },
        }
    };
</script>
#+END_EXPORT

結果、 \bm はうまく斜体太字になったが、 \eqref{} など他のlatexマクロが逆にうまく表示されなくなってしまうという問題が発生しました。

解決策

よく調べてみると、 ox-html の変数に、 org-html-mathjax-template というものがあり、そこにMathJaxの設定を書き込むことで、latexマクロをHTML上で認識させることができることがわかりました。

テコちゃんのconfigを参考に、以下の設定config.orgに追加することで解決しました。

(setq org-html-mathjax-template
  "<script>
  window.MathJax = {
    loader: {
      load: ['[tex]/mathtools'],
    },
    tex: {
      ams: {
        multlineWidth: '%MULTLINEWIDTH'
      },
      tags: '%TAGS',
      tagSide: '%TAGSIDE',
      tagIndent: '%TAGINDENT',
      packages: {'[+]': ['mathtools']},
      macros: {
        RR: ['\\\\ifstrempty{#1}{\\\\mathbb{R}}{\\\\mathbb{R}^{#1}}', 1, ''],
        NN: ['\\\\ifstrempty{#1}{\\\\mathbb{N}}{\\\\mathbb{N}^{#1}}', 1, ''],
        ZZ: ['\\\\ifstrempty{#1}{\\\\mathbb{Z}}{\\\\mathbb{Z}^{#1}}', 1, ''],
        QQ: ['\\\\ifstrempty{#1}{\\\\mathbb{Q}}{\\\\mathbb{Q}^{#1}}', 1, ''],
        CC: ['\\\\ifstrempty{#1}{\\\\mathbb{C}}{\\\\mathbb{C}^{#1}}', 1, ''],
        bm: ['\\\\boldsymbol{#1}', 1], ;; <- ここに\bmの設定を追加
        EE: '\\\\mathbb{E}',
        Lap: '\\\\operatorname{\\\\mathcal{L}}',
        Var: '\\\\operatorname{Var}',
        Cor: '\\\\operatorname{Cor}',
        E: '\\\\operatorname{E}',
      },
      mathtools: {
        pairedDelimiters: {
          abs: ['\\\\lvert', '\\\\rvert'],
          norm: ['\\\\lVert', '\\\\rVert'],
          ceil: ['\\\\lceil', '\\\\rceil'],
          floor: ['\\\\lfloor', '\\\\rfloor'],
          round: ['\\\\lfloor', '\\\\rceil'],
        }
      }
    },
    chtml: {
      scale: %SCALE,
      displayAlign: '%ALIGN',
      displayIndent: '%INDENT'
    },
    svg: {
      scale: %SCALE,
      displayAlign: '%ALIGN',
      displayIndent: '%INDENT'
    },
    output: {
      font: '%FONT',
      displayOverflow: '%OVERFLOW'
    }
  };
</script>

<script
  id=\"MathJax-script\"
  async
  src=\"%PATH\">
</script>")

これでどんなlatexマクロもHTML上で認譫させることができますね!

ox-hugoのreferenceがうまく表示されない問題

Tue, 12 Nov 2024 14:40:00 +0900

問題

Org Cite Citationsを使って

#+print_bibliography:

でreferenceを表示しようとしたが、“References"というヘッダのみが表示され、referenceのリストが表示されなかった。 content/ の中のmdファイルを見ると、htmlとして、referenceのリストが書き出されていたが、 public/ の中のhtmlファイルを見ると、referenceのリストが表示されていなかった。よって、 org -> md -> html という変換の md -> html の部分で問題があると考え、調べてみると、同じ問題についてのissueが立っており、以下の解決策にたどり着いた。

解決策

config.tomlに

[markup.goldmark.renderer]
  unsafe = true

を追加することで解決できる

自分の場合はymlを使っていたので、以下のように設定した。

markup:
  goldmark:
    renderer:
      unsafe: true

解説

Goldmark — ox-hugo - Org to Hugo exporter で書かれているように、 Hugo v0.60.0以降、デフォルトのMarkdownパーサーはCommonMark準拠のGoldmarkに変更された。以前のデフォルトパーサーであるBlackfridayは、仕様に準拠しておらず、多くのバグを抱えていたらしく、ox-hugoを使い続ける場合は、特別な理由がない限り、Goldmarkに移行することが推奨されている。

ただし、Goldmark/Hugoには、Blackfridayと比較してMarkdownのパース方法にいくつかの問題があり、その一つが、今回の問題である、インラインHTMLがうまく表示されないというものっぽい。

この解決策によって、Markdown内でインラインHTML を使用できるようになるということらしい。

Emacs on かおるのブログ

gpt.el & mcp.el で整う emacs llm環境

はじめに

gptel とは

NixOSのエラー: Could not start dynamically linked executable の対処法についてのメモ

症状とエラーメッセージ

解決策：nix-ld を有効にする

ox-hugo で mermaid.js を使う方法

はじめに

Doom Emacs & Mac へのSKK導入ガイド

この記事で分かること

SKKとは

SKKとわたし

AquaSKKの導入

最強のAnki用単語学習Cardを作った

はじめに

理想の単語カードに求める機能

既存のカードとの比較、そしてSuper Vocab誕生へ

anki-editorとEmacs、立ちはだかる壁、そしてPull Requestへ

emacs起動時の、 Project … cannot be read

問題

解決策

参考

Server julia-ls starting exited (check corresponding stderr buffer for details). Do you want to restart it? (y or n) の解決策

問題

解決策

参考

『Pythonではじめる時系列分析入門』のorg version repoを作ったよ

emacsをupgradeしたらankiの数式が汚くなったので直した

導入

解決策

この解決策に至った背景

ox-htmlで\bmなどのlatexマクロを使う方法

問題

最初に試した方法

解決策

ox-hugoのreferenceがうまく表示されない問題

問題

解決策

解説

`gptel` とは