mcpField
M
Microtoll Engine

Microtoll Engine

ローカル
microtoll.dev開発ツール14 週間前に更新
リポジトリ公式サイト

Microtoll Engine について

Microtoll Engine は、コーディングツール向けにエンジンの同梱ドキュメントとアプリ用のひな形を提供する MCP サーバーです。ローカルのドキュメント検索・閲覧と、ネットワークを使わない空ディレクトリへのファイル作成ができます。

主な機能

  1. 01同梱ドキュメントの全文検索
  2. 02ドキュメントページの Markdown 読み込み
  3. 03空ディレクトリへの notes アプリひな形の作成
  4. 04namespace や origin などの値の反映
  5. 05空でないディレクトリを拒否し、上書きを回避

活用シーン

  1. 01コーディングツールから Microtoll Engine のドキュメントを検索
  2. 02エディターで参照先のドキュメントページを読む
  3. 03生成されたひな形ファイルからエンジンのプロジェクトを開始

MCP 対応

標準入出力で MCP を実装し、互換ホストにドキュメント検索、ページ読み込み、プロジェクトひな形作成の3つのツールを公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "microtoll": {
      "command": "npx",
      "args": [
        "-y",
        "@microtoll/mcp"
      ]
    }
  }
}
起動コマンドnpx -y @microtoll/mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@microtoll/mcp0.1.3

ツール

3

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
limitintegerいいえ
querystringはい探したい内容を語句で指定します。

詳細

@microtoll/mcp

コーディングツール内で使える Microtoll Engine です。Claude Code、Cursor、およびあらゆる MCP ホストから呼び出せる（標準入力と標準出力を使用する）Model Context Protocol サーバーです。エージェントがエディターを離れることなくエンジンを組み込めるよう、ドキュメントとプロジェクトのひな形を提供します。マシンから離れる必要もありません。ページはパッケージ内に含まれており、何も取得せず、src/ 内にあるもの以外は実行しません。

ステータス： npm で @microtoll/mcp として公開され、MCP レジストリに io.github.microtoll/mcp として登録されています。Apache-2.0。依存関係はありません。Node 24 以降が必要です。

ホストに追加する

claude mcp add microtoll -- npx -y @microtoll/mcp

ほかのホストでも、stdio サーバーとして同じコマンド（npx -y @microtoll/mcp）を使用します。

3 つのツール

ツール機能
microtoll_search_docs({ query, limit? })ドキュメントの全文検索です。microtoll.dev と同じページが、リポジトリのドキュメントビルドによって generated/docs.json に含まれているため、内容が食い違うことはありません。ページ、セクション、抜粋を返します。
microtoll_read_doc({ path })検索結果で示された path（packages/access.html）、または llms.txt から指定した 1 ページを Markdown 形式で返します。
microtoll_scaffold({ directory, namespace?, origin?, name? })空のディレクトリにノート用のスターター一式を書き込みます。内容は notes.js、page.js、index.html、docker-compose.yml、nginx.conf、package.json、README.md で、namespace と origin を入力済みです。ファイルのみを書き込みます。空でないディレクトリは拒否し、既存ファイルを上書きすることはありません。次の手順（npm install、docker compose up）は、ユーザーが実行できるようテキストで提示されます。

各ツールには、簡潔な title と仕様の動作ヒント（annotations）も含まれており、ホストはこれらを使って、先にユーザーに確認するかどうかを判断できます。2 つのドキュメントツールは読み取りのみを行います。スキャフォールドツールはファイルを書き込みますが、追加のみで（削除や上書きはしません）、同じ引数で 2 回目に呼び出しても何も変更されません。3 つのツールはいずれもネットワークを使用しません。

対応するプロトコル

JSON-RPC 2.0 で、1 行につき 1 メッセージです。initialize（プロトコルバージョン 2025-06-18、tools 機能）、ping、tools/list、tools/call に対応します。通知には無応答で応答し、ツールの失敗は isError を含むツール結果で、プロトコルの失敗は JSON-RPC エラーで返します。src/protocol.js は約 120 行で、ホストが送信するメッセージの記録を使ってテストしています。

テスト

npm test：実際の子プロセスを使ったプロトコル、同梱スナップショットを使った検索とページリーダー、一時ディレクトリへのスキャフォールド（プレースホルダーが入力されること、空でないディレクトリが拒否されること）、および各ツールの title と動作ヒントがツールの動作と一致することをテストします。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。