Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AS400 MCP Servershow me the structure and column labels for the CUSTOMER table in MYLIB"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AS400 MCP Server
Claude Code用のAS400/IBM i開発支援MCPサーバーです。 ODBC経由でAS400のメタデータやソースコードを取得し、CL/RPG/COBOLプログラムの開発を支援します。
特徴
日本語ラベル対応: カラムやテーブルの日本語説明（TEXT）を取得・活用
ソースコード参照: QCLSRC/QRPGSRC等からソースを取得
プログラム依存関係調査: 参照ファイル・呼び出し関係を取得
システム情報取得: OSバージョン、PTFレベル等を確認
読み取り専用: セキュリティのため全て読み取り操作のみ
利用可能なツール
ツール | 説明 |
| ライブラリ一覧（ラベル付き） |
| テーブル/ファイル一覧 |
| カラム一覧（日本語ラベル、型、キー情報） |
| ソースファイル一覧（QCLSRC, QRPGSRC等） |
| ソースメンバー一覧 |
| ソースコード取得 |
| テーブルデータ取得 |
| テーブル詳細情報 |
| システム情報（OSバージョン、PTF等） |
| プログラム一覧（RPG/CL/COBOL等） |
| プログラムの参照ファイル・呼び出し関係 |
| データエリア一覧（共有変数） |
| 任意SELECT実行（読み取り専用） |
インストール
前提条件
Python 3.10以上
IBM i Access ODBC Driver
AS400/IBM i 7.3以上（推奨: 7.4以上）
7.3: 基本機能が動作
7.4+:
get_program_references等の追加機能が利用可能
AS400/IBM iへの接続情報
インストール手順
# 1. リポジトリをクローン
git clone https://github.com/omni-s/as400-mcp.git
cd as400-mcp
# 2. 仮想環境を作成・有効化
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate
# 3. パッケージをインストール
pip install -e .Claude Code設定
実際にClaude Codeを動かすプロジェクトルートに .mcp.json ファイルを作成してください。
接続情報（パスワード等）を含む場合は .gitignore に .mcp.json を追加することを推奨します。
Windows（.mcp.json）
{
"mcpServers": {
"as400": {
"command": "C:/path/to/as400-mcp/.venv/Scripts/python.exe",
"args": ["-m", "as400_mcp.server"],
"env": {
"AS400_CONNECTION_STRING": "DRIVER={IBM i Access ODBC Driver};SYSTEM=YOUR_SYSTEM;UID=USER;PWD=PASS;CCSID=1208;EXTCOLINFO=1"
}
}
}
}Linux/macOS（.mcp.json）
{
"mcpServers": {
"as400": {
"command": "/path/to/as400-mcp/.venv/bin/python",
"args": ["-m", "as400_mcp.server"],
"env": {
"AS400_CONNECTION_STRING": "DRIVER={IBM i Access ODBC Driver};SYSTEM=YOUR_SYSTEM;UID=USER;PWD=PASS;CCSID=1208;EXTCOLINFO=1"
}
}
}
}設定後、Claude Codeを再起動して /mcp コマンドでas400サーバーが表示されることを確認してください。
接続文字列のオプション
オプション | 説明 |
| AS400のホスト名またはIPアドレス |
| ユーザーID |
| パスワード |
| UTF-8通信（日本語対応） |
| 拡張カラム情報（COLUMN_TEXT等）を取得 |
使い方
基本的なワークフロー
ユーザー: MYLIBの受注テーブルを使ったWeb画面を作って
Claude Code:
1. get_table_info("MYLIB", "ORDER") でテーブル情報取得
2. カラム情報（日本語ラベル付き）を確認
3. get_data でサンプルデータを確認
4. Web画面（React等）とAPI（FastAPI等）を生成使用例
テーブル構造確認
> MYLIBのORDERテーブルの構造を教えて既存ソース参照
> MYLIBのソースファイル一覧を見せて
> MYLIB/QRPGSRC内のORDMNTソースを見せてプログラム調査
> MYLIBにあるRPGプログラムの一覧を見せて
> ORDER001プログラムが参照しているファイルを教えてWeb画面生成
> MYLIBのCUSTOMERテーブルでWebの一覧・詳細画面を作って
- 日本語ラベルを画面項目名に
- 検索機能付きシステム情報確認
> AS400のバージョンを教えてODBCドライバーの設定
ODBCドライバーの導入方法については、以下の公式ドキュメントを参照してください。
IBM i Access ODBC Installation
開発
Claude Code無しでテストする
MCPサーバーはClaude Code無しでも動作確認できます。
# .env.exampleをコピーして接続情報を設定
cp .env.example .env
# .envを編集して接続情報を入力
# 直接起動（stdinにJSON-RPCを入力）
python -m as400_mcp.server
# ツール一覧を取得
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | python -m as400_mcp.server上記はClaude Code経由ではなく単独でas400-mcp動作させたい場合です。
MCP Inspector（推奨）
Anthropic提供のデバッグ用WebUIでGUIからツールをテストできます。
npx @modelcontextprotocol/inspector python -m as400_mcp.server「Claude Code無しでテストする」の .env の編集は行ってある事が前提です
ブラウザが開き、ツール一覧の確認や実行テストが可能です。
ユニットテスト
# 開発用依存パッケージをインストール
pip install -e ".[dev]"
# テスト実行
pytest tests/ -vリント
ruff check .
ruff format .トラブルシューティング
接続エラー
[HY000] [IBM][System i Access ODBC Driver]Communication link failure→ SYSTEM、UID、PWDを確認。ファイアウォールでポート446/449/8470等が開いているか確認。
文字化け
UnicodeDecodeError→ 接続文字列にCCSID=1208を追加（UTF-8通信）。
日本語ラベルが取得できない
COLUMN_TEXT が空→ 接続文字列にEXTCOLINFO=1を追加。
権限エラー
[42501] User not authorized to object→ AS400側でユーザーにQSYS2カタログビューへのアクセス権限を付与。
ライセンス
MIT License - Copyright (c) 2025 kozokaAI Inc.