MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
80 Java-focused tools for files, MySQL, JavaFX, Spring Boot and JS-to-Java migration, over stdio.
作者による原文
この種の作業を AI に教える Skill。これと一緒に使えます
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 6/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 18/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
JavaBytes をインストールして。https://mcp.popnx.com/i/markymakes-dev-javabytes.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月20日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
JavaBytes のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server JavaBytes を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "javabytes": { "command": "npx", "args": [ "-y", "javabytes-mcp" ], "env": { "JAVABYTES_DB_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) JAVABYTES_DB_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、JavaBytes のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
SettingsDeveloperEdit Config
{
"mcpServers": {
"javabytes": {
"command": "npx",
"args": [
"-y",
"javabytes-mcp"
],
"env": {
"JAVABYTES_DB_PASSWORD": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
JavaBytes を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が JavaBytes を使っていると言うか、回答に JavaBytes のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
JAVABYTES_ALLOWED_DIRS ファイルシステムのサンドボックスのルート(デフォルトは作業ディレクトリと JVM の一時ディレクトリ) JAVABYTES_DB_URL MySQL ツール用の JDBC URL JAVABYTES_DB_USER MySQL ユーザー 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ JavaBytes につなげません
JavaBytes はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · JavaBytes につなげるアプリを使う
Claude Code につなげますが、先に準備が必要です
JavaBytes のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server JavaBytes を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user javabytes --env JAVABYTES_DB_PASSWORD=your-value -- npx -y javabytes-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) JAVABYTES_DB_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、JavaBytes のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user javabytes --env JAVABYTES_DB_PASSWORD=your-value -- npx -y javabytes-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
JavaBytes が一覧にあり、接続済みと表示されれば OK です
JavaBytes を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が JavaBytes を使っていると言うか、回答に JavaBytes のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
JAVABYTES_ALLOWED_DIRS ファイルシステムのサンドボックスのルート(デフォルトは作業ディレクトリと JVM の一時ディレクトリ) JAVABYTES_DB_URL MySQL ツール用の JDBC URL JAVABYTES_DB_USER MySQL ユーザー 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
JavaBytes のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server JavaBytes を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "javabytes": { "command": "npx", "args": [ "-y", "javabytes-mcp" ], "env": { "JAVABYTES_DB_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) JAVABYTES_DB_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、JavaBytes のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
JavaBytes の設定で JAVABYTES_DB_PASSWORD が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
JavaBytes を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が JavaBytes を使っていると言うか、回答に JavaBytes のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
JAVABYTES_ALLOWED_DIRS ファイルシステムのサンドボックスのルート(デフォルトは作業ディレクトリと JVM の一時ディレクトリ) JAVABYTES_DB_URL MySQL ツール用の JDBC URL JAVABYTES_DB_USER MySQL ユーザー 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
JavaBytes のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server JavaBytes を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "javabytes": { "type": "stdio", "command": "npx", "args": [ "-y", "javabytes-mcp" ], "env": { "JAVABYTES_DB_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) JAVABYTES_DB_PASSWORD は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、JavaBytes のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
JavaBytes の設定で JAVABYTES_DB_PASSWORD が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
JavaBytes を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が JavaBytes を使っていると言うか、回答に JavaBytes のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
JAVABYTES_ALLOWED_DIRS ファイルシステムのサンドボックスのルート(デフォルトは作業ディレクトリと JVM の一時ディレクトリ) JAVABYTES_DB_URL MySQL ツール用の JDBC URL JAVABYTES_DB_USER MySQL ユーザー 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code
claude mcp add --scope user javabytes --env JAVABYTES_DB_PASSWORD=your-value -- npx -y javabytes-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"javabytes": {
"command": "npx",
"args": [
"-y",
"javabytes-mcp"
],
"env": {
"JAVABYTES_DB_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"javabytes": {
"command": "npx",
"args": [
"-y",
"javabytes-mcp"
],
"env": {
"JAVABYTES_DB_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"javabytes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"javabytes-mcp"
],
"env": {
"JAVABYTES_DB_PASSWORD": "your-value"
}
}
}
}JAVABYTES_ALLOWED_DIRS envJAVABYTES_DB_URL envJAVABYTES_DB_USER envJAVABYTES_DB_PASSWORD 秘密 必須 env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント markymakes-dev で確認済みです
コードの最終更新:昨日
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
まだ確認していません
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/markymakes-dev-javabytes)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:JAVABYTES_DB_PASSWORD
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は昨日、最新バージョン(1.5.0)がレジストリに届いたのは今日です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| これ JavaBytes | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 |
| キーが必要 | はい | いいえ | いいえ | はい | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | はい | いいえ |
| 基本チェック | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| ライセンス | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
A general-purpose Java MCP (Model Context Protocol) server that speaks JSON-RPC 2.0 over stdio.
It exposes Java-oriented tools for file access, MySQL, JavaFX canvas rendering/export, project diagnostics, and code/CSS generation. It has no MCP SDK dependency: the protocol is implemented directly with Jackson.
Scope note: tools that only reword a prompt (most
*_generate_*tools) are conveniences.
The tools that add real capability are the ones that touch the world: the file sandbox, live
MySQL, JavaFX rendering, and project inspection.
npx launcher)The javabytes-mcp package bundles the shaded jar, so a client only needs Node.js and Java:
npx -y javabytes-mcp
It resolves java from JAVABYTES_JAVA, then JAVA_HOME, then PATH, and the jar from JAVABYTES_JAR or the bundled copy.
Client config — Claude Desktop and most clients:
{
"mcpServers": { "javabytes": { "command": "npx", "args": ["-y", "javabytes-mcp"], "env": { "JAVABYTES_DB_URL": "jdbc:mysql://localhost:3306/appdb", "JAVABYTES_DB_USER": "app", "JAVABYTES_DB_PASSWORD": "change-me" } } } }
OpenCode (~/.config/opencode/opencode.json) uses a different shape — mcp, a command array, and environment rather than env:
{
"mcp": { "javabytes": { "type": "local", "command": ["npx", "-y", "javabytes-mcp"], "environment": { "JAVABYTES_DB_URL": "jdbc:mysql://localhost:3306/appdb", "JAVABYTES_DB_USER": "app", "JAVABYTES_DB_PASSWORD": "change-me" }, "enabled": true } } }
# 1. Check your environment
npx -y javabytes-mcp doctor
npx -y javabytes-mcp config --client=opencode # → ~/.config/opencode/opencode.json npx -y javabytes-mcp config --client=claude # → claude_desktop_config.json npx -y javabytes-mcp config --client=cursor # → Cursor MCP settings npx -y javabytes-mcp config --client=vscode # → .vscode/mcp.json
Example doctor output:
PASS java: 21.0.5 via JAVA_HOME (/usr/lib/jvm/java-21-openjdk/bin/java)
PASS jar: present (15.8 MB) INFO db: JAVABYTES_DB_URL is not set - MySQL tools will be unconfigured PASS update: up to date (1.2.0) 4 checks, 0 problems
Quick reference for config locations:
| Client | Config command | Where to paste |
|---|---|---|
| OpenCode | npx -y javabytes-mcp config --client=opencode | ~/.config/opencode/opencode.json |
| Claude Desktop | npx -y javabytes-mcp config --client=claude | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) |
| Cursor | npx -y javabytes-mcp config --client=cursor | ~/.cursor/mcp.json |
| VS Code | npx -y javabytes-mcp config --client=vscode | .vscode/mcp.json in your workspace |
Then set your real DB credentials:
# Optional: configure MySQL for live queries
export JAVABYTES_DB_URL=jdbc:mysql://localhost:3306/yourdb export JAVABYTES_DB_USER=youruser export JAVABYTES_DB_PASSWORD=yourpassword
The doctor command checks Java ≥ 21, the bundled jar, MySQL env, and npm updates. The config command prints ready-to-paste JSON with placeholders — just update the password and database URL, then restart your client.
mvn clean test # 146 unit tests (6 more run live only when JAVABYTES_RUN_DB_TESTS=1)
mvn package # produces target/javabytes.jar (shaded, runnable)
Run from source:
mvn -q exec:java
Run the shaded jar:
java -jar target/javabytes.jar
stdout is reserved for JSON-RPC. All logging goes to stderr.
| Variable | Default | Purpose |
|---|---|---|
JAVABYTES_ALLOWED_DIRS | working dir + JVM temp dir | Fallback filesystem sandbox roots |
JAVABYTES_ENABLE | category defaults | Enable/disable tools by group or name |
JAVABYTES_DISABLE | category defaults | Disable specific tools |
JAVABYTES_LOG_FILE | unset | Optional JSON-RPC trace log |
JAVABYTES_DB_URL | jdbc:mysql://localhost:3306/appdb | MySQL JDBC URL |
JAVABYTES_DB_USER | app | MySQL user |
JAVABYTES_DB_PASSWORD | change-me | MySQL password |
Example:
JAVABYTES_ALLOWED_DIRS=/home/me/projects java -jar target/javabytes.jar
Tools are grouped, and a group can be toggled without touching code:
| Group | Default | Contents |
|---|---|---|
files | on | sandboxed filesystem tools |
database | on | read-only MySQL query/list/describe |
system | on | system info, time conversion, version, tool list |
json | on | JSON path query |
javafx | on | off-screen canvas, drawing and PNG export |
analysis | on | code/UI/security/TODO analysis and Spring Boot inspection |
diagnostics | on | evidence-based project diagnostics |
ui, design, codegen, springboot | off | template generators |
A fresh server exposes 50 capability tools; the 30 template generators are opt-in (JAVABYTES_ENABLE=all exposes all 80).
Enable or disable by group or by individual tool name:
# Add every Spring Boot and code generator
JAVABYTES_ENABLE=springboot,codegen java -jar target/javabytes.jar
JAVABYTES_ENABLE=all JAVABYTES_DISABLE=delete_file java -jar target/javabytes.jar
Precedence, highest first: disabled by tool name → enabled by tool name → disabled group → enabled group → all in the disable list → all in the enable list → the group default. tools/list only advertises enabled tools; calling a disabled tool returns JSON-RPC -32602 with the flag needed to enable it.
Every tool descriptor also carries a title and MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) so clients can ask for confirmation or auto-approve reads.
If the client advertises capabilities.roots, the server requests roots/list after initialization and again after notifications/roots/list_changed. Usable file:// roots replace the environment sandbox for the session, narrowing what file tools may touch. If the client returns no usable roots, or the request fails, the JAVABYTES_ALLOWED_DIRS fallback stays in effect. Filesystem roots such as C:\ and / are refused so a misconfiguration cannot expose the whole disk.
| Tool | What it does |
|---|---|
query_database | Read-only SQL (SELECT/SHOW/DESCRIBE/EXPLAIN/WITH), max 1000 rows |
list_tables | Tables and views |
describe_table | Column metadata; identifiers are validated and backtick-quoted |
javafx_init_canvas | Create an off-screen canvas |
javafx_draw_canvas | Draw rectangle/circle/line/text |
javafx_set_color | Set fill/stroke color |
javafx_clear_canvas | Clear the canvas |
javafx_export_image | Snapshot to a real PNG via SwingFXUtils + ImageIO |
project_diagnostic | Evidence-based dependency/configuration check |
analyze_springboot_project | Spring Boot layout inspection |
extract_data_models | Parse mongoose/prisma/sequelize/SQL/JSON data declarations into tables and columns, with per-field confidence and an honest limitations list |
models_to_schema | Convert parsed schema models into normalized schema proposals: proposed DDL, pass-through verdicts, and a verification list of medium/low-confidence fields |
generate_database | Execute proposed normalized DDL against a user-supplied JDBC URL to create the schema (creates only; refuses existing-table collision unless confirm=true) |
fix_javafx_headless | Adds the Monocle property (dry run by default; apply=true to write) |
create_mysql_client | Generates a self-contained JDBC helper that reads credentials from env |
get_system_info | JVM/OS/hardware info |
environment_variables | Read env vars; secret-like values masked unless reveal=true |
read_text_file, write_file, list_directory, get_file_info, make_directory, delete_file, search_files (glob + optional content regex), backup_file (no overwrite), compare_files.
generate_code, generate_tests, generate_docs, refactor_code, check_security, find_todos, analyze_code, generate_css, generate_ui_code, generate_javafx_component, extract_design_system, analyze_ui_layout, html_css_to_javafx_css, design_tokens, anti_slop_review, translate_webapp, json_query, convert_time, get_version, list_services, and the springboot_generate_* family (entity, repository, service, controller, DTO, properties, security, relationship, actuator, exception handler, validation, pagination, file upload, scheduled, async, cache, profile, docker, test).
These emit templates. They do not compile or run the result. Prefer prompting for anything beyond their exact shape. All of them are disabled by default; enable them with JAVABYTES_ENABLE=ui,design,codegen,springboot (or all).
Alongside tools the server advertises the MCP prompts capability and ships four prompt templates — the crew pack — mapped 1:1 to the java-anything pipeline phases:
recon — analyze the source app, choose the UI strategy with the human (ask-first wizard, ADR 0004/0013), produce the wave-ordered ticket list.port — translate the honest subset per unit, hand-write the rest, record cases for the gate.verify — run the migration gate per unit; a unit is done only when recorded behavior replays.report — assemble the Converted / Manual work / Unverified split; claims end where evidence ends.Prompts are documentation: always advertised, never feature-gated, they call no tools and carry no logic. A drift test in CI asserts every tool name a prompt references still exists in the catalog, so renames can never silently break the crew manual.
Every tool descriptor in tools/list carries a derived outputSchema — the result envelope as a machine-checkable contract: success (boolean, required), error and message (optional strings), tool-specific payload keys permitted. Successful tools/call results also carry structuredContent: the envelope as a real JSON object, so typed clients (MCP Inspector, FastMCP-style clients, IDE integrations) read results as data instead of re-parsing a string. Error results omit structuredContent per the MCP spec; the envelope still travels in text content, so text-reading clients see zero change. The schema is derived once in the same place input schemas are rendered — no per-tool annotation, no drift, no new dependency (conformance is a CI round-trip test, not a runtime validator).
AppConfig.isPathAllowed rejects empty paths and null bytes, normalizes, resolves the real path of the deepest existing ancestor (so non-existent targets and symlinks are handled), and compares on component boundaries. C:\dev-evil never matches C:\dev.MyDatabaseClient.query validates the statement, refuses multiple statements, sets the connection read-only, caps rows,(sf and applies a query timeout.describe_table accepts only plain identifiers or schema.table.