Ibmi MCP Server

Claude Codeは、ローカル (stdio) およびリモート (HTTP) のMCPサーバー接続をサポートしています。CLIを使用するか、.mcp.json を直接編集してサーバーを構成できます。

オプション1: ローカルStdioサーバー (推奨)

CLIを使用する場合:

# ローカルstdioサーバーを追加
claude mcp add ibmi-mcp \
  --env DB2i_HOST=your-ibmi-host.com \
  --env DB2i_USER=your-username \
  --env DB2i_PASS=your-password \
  --env DB2i_PORT=8076 \
  --env MCP_TRANSPORT_TYPE=stdio \
  -- npx ibmi-mcp-server --tools /absolute/path/to/prebuiltconfigs

.mcp.json を使用する場合:

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio",
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

オプション2: リモートHTTPサーバー

CLIを使用する場合:

# 認証付きのリモートHTTPサーバーを追加
claude mcp add --transport http ibmi-mcp http://localhost:3010/mcp \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN_HERE"

.mcp.json を使用する場合:

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

環境変数の展開

Claude Codeは、.mcp.json ファイルでの環境変数の展開をサポートしており、資格情報を安全に管理できます。

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "${IBMI_TOOLS_PATH}"],
      "env": {
        "DB2i_HOST": "${DB2i_HOST}",
        "DB2i_USER": "${DB2i_USER}",
        "DB2i_PASS": "${DB2i_PASS}",
        "DB2i_PORT": "${DB2i_PORT:-8076}",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

サポートされる構文:

• ${VAR} - 環境変数 VAR の値に展開
• ${VAR:-default} - VAR が設定されている場合はその値に、そうでない場合は default に展開

サーバーの管理

# 構成されたサーバーのリストを表示
claude mcp list

# サーバーの詳細を取得
claude mcp get ibmi-mcp

# サーバーを削除
claude mcp remove ibmi-mcp

# Claude Codeでサーバーの状態を確認
/mcp

📖 Claude Code MCPドキュメント

ローカル (Stdio)

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) を編集します。

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

リモート (HTTP)

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 Claude Desktop MCPセットアップ

VSCodeは、Copilot Chatを通じてMCPサーバーをサポートしています。設定ファイルまたはCLIを使用して、ユーザーまたはワークスペースレベルでサーバーを構成できます。

前提条件: GitHub Copilot がインストールされ、有効になっていることを確認してください。

設定ファイルの場所

• ワークスペース: .vscode/mcp.json (バージョン管理を通じてチームと共有)
• ユーザー: ユーザープロファイルディレクトリ内の mcp.json
  • macOS/Linux: ~/.config/Code/User/globalStorage/modelcontextprotocol.mcp/mcp.json
  • Windows: %APPDATA%\Code\User\globalStorage\modelcontextprotocol.mcp\mcp.json

オプション1: ローカルStdioサーバー

CLIを使用する場合:

# ローカルstdioサーバーを追加
code --add-mcp '{
  "name": "ibmiMcp",
  "type": "stdio",
  "command": "npx",
  "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
  "env": {
    "DB2i_HOST": "your-ibmi-host.com",
    "DB2i_USER": "your-username",
    "DB2i_PASS": "your-password",
    "DB2i_PORT": "8076",
    "MCP_TRANSPORT_TYPE": "stdio"
  }
}'

mcp.json を使用する場合:

{
  "servers": {
    "ibmiMcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

オプション2: リモートHTTPサーバー

CLIを使用する場合:

# リモートHTTPサーバーを追加
code --add-mcp '{
  "name": "ibmiMcp",
  "type": "http",
  "url": "http://localhost:3010/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
  }
}'

mcp.json を使用する場合:

{
  "servers": {
    "ibmiMcp": {
      "type": "http",
      "url": "http://localhost:3010/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

入力変数を使用した安全な資格情報管理

VSCodeは、入力変数をサポートしており、機密性の高い資格情報をハードコーディングせずに管理できます。

{
  "inputs": [
    {
      "id": "db2iHost",
      "type": "promptString",
      "description": "IBM i DB2ホストアドレス"
    },
    {
      "id": "db2iUser",
      "type": "promptString",
      "description": "IBM iユーザー名"
    },
    {
      "id": "db2iPass",
      "type": "promptString",
      "description": "IBM iパスワード",
      "password": true
    }
  ],
  "servers": {
    "ibmiMcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "${input:db2iHost}",
        "DB2i_USER": "${input:db2iUser}",
        "DB2i_PASS": "${input:db2iPass}",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

VSCodeは、サーバー起動時にこれらの値を入力するように促し、資格情報を安全に管理します。

サーバーの管理

• サーバーを表示: アクティビティバーのCopilot Chatビューを確認
• サーバーを再起動: コマンドパレット (Cmd/Ctrl+Shift+P) → "MCP: Restart Server" を使用
• サーバーを無効にする: mcp.json から削除するか、設定で無効にする

📖 VSCode MCPドキュメント

ローカル (Stdio)

Cursor設定または .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

リモート (HTTP)

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 Cursor MCPドキュメント

ローカル (Stdio)

Windsurf構成に追加します。

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

リモート (HTTP)

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 Windsurf MCPドキュメント

ローカル (Stdio)

Roo Code設定で構成します。

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

リモート (HTTP)

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 Roo Code MCPドキュメント

ローカル (Stdio)

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio",
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

リモート (HTTP)

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 LM Studio MCPサポート

ローカル (Stdio)

MCPオブジェクト内で "type": "local" を使用してローカルMCPサーバーを追加します。複数のMCPサーバーを追加できます。各サーバーのキー文字列は任意の名前にできます。

opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ibmi-mcp": {
      "type": "local",
      "enabled": true,
      "command": ["npx", "ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "environment": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      },
      "enabled": true
    }
  }
}

サーバーを一時的に無効にする場合は、enabledをfalseに設定できます。これは、サーバーを設定から削除せずに一時的に無効にしたい場合に便利です。

リモート (HTTP)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ibmi-mcp": {
      "type": "remote",
      "enabled": true,
      "url": "http://localhost:3010/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 OpenCode MCPドキュメント

詳細については、Gemini CLI構成 を参照してください。

1. Gemini CLI設定ファイルを開きます。場所は ~/.gemini/settings.json (ここで ~ はホームディレクトリ) です。
2. settings.json ファイルの mcpServers オブジェクトに以下を追加します。

ローカル (Stdio)

Gemini CLI設定で構成します。

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

リモート (HTTP)

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 Gemini CLI MCPドキュメント

Clineは、マーケットプレイスと手動構成の両方を通じてMCPサーバーをサポートしています。

前提条件: Cline がVSCodeにインストールされていることを確認してください。

オプション1: 手動構成

ローカル (Stdio) サーバーの場合:

1. Cline を開きます。
2. ハンバーガーメニューアイコン (☰) をクリック → MCP Servers を選択。
3. Local Servers タブを選択。
4. Edit Configuration をクリック。
5. 以下の構成を追加します。

{
  "mcpServers": {
    "ibmi-mcp": {
      "command": "npx",
      "args": ["ibmi-mcp-server", "--tools", "/absolute/path/to/prebuiltconfigs"],
      "env": {
        "DB2i_HOST": "your-ibmi-host.com",
        "DB2i_USER": "your-username",
        "DB2i_PASS": "your-password",
        "DB2i_PORT": "8076",
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

リモート (HTTP) サーバーの場合:

1. Cline を開きます。
2. ハンバーガーメニューアイコン (☰) をクリック → MCP Servers を選択。
3. Remote Servers タブを選択。
4. Edit Configuration をクリック。
5. 以下の構成を追加します。

{
  "mcpServers": {
    "ibmi-mcp": {
      "url": "http://localhost:3010/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

📖 Cline MCPドキュメント | Cline MCPマーケットプレイス

Agnoを使用したリモート (HTTP)

import asyncio
import os
from agno.agent import Agent
from agno.tools.mcp import MCPTools, StreamableHTTPClientParams

# 環境からアクセストークンを取得
token = os.environ.get('IBMI_MCP_ACCESS_TOKEN')
if not token:
    raise ValueError("IBMI_MCP_ACCESS_TOKEN not set")

url = "http://localhost:3010/mcp"
server_params = StreamableHTTPClientParams(
    url=url,
    headers={"Authorization": f"Bearer {token}"}
)

async def main():
    async with MCPTools(
        url=url,
        server_params=server_params,
        transport="streamable-http"
    ) as tools:
        # 利用可能なツールをリストする
        result = await tools.session.list_tools()
        print(f"利用可能なツール: {[t.name for t in result.tools]}")

        # エージェントを作成
        agent = Agent(
            model="openai:gpt-4o",  # またはお好みのモデル
            tools=[tools],
            name="ibmi-agent",
            show_tool_calls=True
        )

        # クエリを実行
        await agent.aprint_response("What is the system status?")

if __name__ == "__main__":
    asyncio.run(main())

公式MCP SDKを使用したリモート (HTTP)

import asyncio
import os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    token = os.environ.get('IBMI_MCP_ACCESS_TOKEN')
    if not token:
        raise ValueError("IBMI_MCP_ACCESS_TOKEN not set")

    headers = {"Authorization": f"Bearer {token}"}

    async with streamablehttp_client(
        "http://localhost:3010/mcp",
        headers=headers
    ) as (read_stream, write_stream, _):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()

            # ツールをリストする
            tools = await session.list_tools()
            print(f"ツール: {[t.name for t in tools.tools]}")

            # ツールを実行
            result = await session.call_tool("system_status", {})
            print(result)

if __name__ == "__main__":
    asyncio.run(main())

📖 MCP Python SDK | Agno Framework