# AS400 MCP Server
Claude Code用のAS400/IBM i開発支援MCPサーバーです。
ODBC経由でAS400のメタデータやソースコードを取得し、CL/RPG/COBOLプログラムの開発を支援します。
## 特徴
- **日本語ラベル対応**: カラムやテーブルの日本語説明（TEXT）を取得・活用
- **ソースコード参照**: QCLSRC/QRPGSRC等からソースを取得
- **プログラム依存関係調査**: 参照ファイル・呼び出し関係を取得
- **システム情報取得**: OSバージョン、PTFレベル等を確認
- **読み取り専用**: セキュリティのため全て読み取り操作のみ
## 利用可能なツール
| ツール | 説明 |
|--------|------|
| `list_libraries` | ライブラリ一覧（ラベル付き） |
| `list_tables` | テーブル/ファイル一覧 |
| `get_columns` | カラム一覧（日本語ラベル、型、キー情報） |
| `list_source_files` | ソースファイル一覧（QCLSRC, QRPGSRC等） |
| `list_sources` | ソースメンバー一覧 |
| `get_source` | ソースコード取得 |
| `get_data` | テーブルデータ取得 |
| `get_table_info` | テーブル詳細情報 |
| `get_system_info` | システム情報（OSバージョン、PTF等） |
| `list_programs` | プログラム一覧（RPG/CL/COBOL等） |
| `get_program_references` | プログラムの参照ファイル・呼び出し関係 |
| `list_data_areas` | データエリア一覧（共有変数） |
| `execute_sql` | 任意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への接続情報
### インストール手順
```bash
# 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）
```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）
```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サーバーが表示されることを確認してください。
### 接続文字列のオプション
| オプション | 説明 |
|-----------|------|
| `SYSTEM` | AS400のホスト名またはIPアドレス |
| `UID` | ユーザーID |
| `PWD` | パスワード |
| `CCSID=1208` | UTF-8通信（日本語対応） |
| `EXTCOLINFO=1` | 拡張カラム情報（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](https://ibmi-oss-docs.readthedocs.io/en/latest/odbc/installation.html)
## 開発
### Claude Code無しでテストする
MCPサーバーはClaude Code無しでも動作確認できます。
```bash
# .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からツールをテストできます。
```bash
npx @modelcontextprotocol/inspector python -m as400_mcp.server
```
> 「Claude Code無しでテストする」の .env の編集は行ってある事が前提です
ブラウザが開き、ツール一覧の確認や実行テストが可能です。
### ユニットテスト
```bash
# 開発用依存パッケージをインストール
pip install -e ".[dev]"
# テスト実行
pytest tests/ -v
```
### リント
```bash
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.
## 関連リンク
- [FastMCP](https://github.com/jlowin/fastmcp)
- [MCP Specification](https://modelcontextprotocol.io/specification/2025-11-25)
