ireporter-mcp

ConMas i-Reporter Web API を Claude などの AI アシスタントから利用するための MCP サーバーです。

セットアップ

$3

ireporter-mcp.mcpb をダウンロードしてダブルクリックすると、Claude Desktop に自動インストールされます。

API URL・ユーザーID・パスワードの入力画面が表示されます。

$3

~/Library/Application Support/Claude/claude_desktop_config.json (Mac) に追加:

``json
{
"mcpServers": {
"ireporter": {
"command": "npx",
"args": [
"-y", "ireporter-mcp",
"--attachments-dir", "/Users/you/Downloads/ireporter"
],
"env": {
"IREPORTER_BASE_URL": "https://your-host.conmas-i-reporter.com/ConMasAPI/Rests/APIExecute.aspx",
"IREPORTER_USER_ID": "your_user",
"IREPORTER_PASSWORD": "your_password"
}
}
}
}
`

$3

`bash
claude mcp add ireporter -- npx -y ireporter-mcp
`

環境変数 IREPORTER_BASE_URL, IREPORTER_USER_ID, IREPORTER_PASSWORD を設定してください。

$3

プロジェクトルートに .cursor/mcp.json を作成:

`json
{
"mcpServers": {
"ireporter": {
"command": "npx",
"args": ["-y", "ireporter-mcp"],
"env": {
"IREPORTER_BASE_URL": "https://your-host.conmas-i-reporter.com/ConMasAPI/Rests/APIExecute.aspx",
"IREPORTER_USER_ID": "your_user",
"IREPORTER_PASSWORD": "your_password"
}
}
}
}
`

$3

~/.gemini/settings.json に追加:

`json
{
"mcpServers": {
"ireporter": {
"command": "npx",
"args": ["-y", "ireporter-mcp"],
"env": {
"IREPORTER_BASE_URL": "https://your-host.conmas-i-reporter.com/ConMasAPI/Rests/APIExecute.aspx",
"IREPORTER_USER_ID": "your_user",
"IREPORTER_PASSWORD": "your_password"
}
}
}
}
`

$3

~/.codex/config.toml に追加:

`toml
[mcp_servers.ireporter]
command = "npx"
args = ["-y", "ireporter-mcp"]

[mcp_servers.ireporter.env]
IREPORTER_BASE_URL = "https://your-host.conmas-i-reporter.com/ConMasAPI/Rests/APIExecute.aspx"
IREPORTER_USER_ID = "your_user"
IREPORTER_PASSWORD = "your_password"
`

または CLI から直接追加:

`bash
codex mcp add ireporter -- npx -y ireporter-mcp
`

ツール一覧

| ツール | 説明 |
|--------|------|
| ireporter-get-definitions | 帳票定義を検索・一覧取得 |
| ireporter-get-definition | 帳票定義の詳細（クラスター構造等）を取得 |
| ireporter-get-records | 入力帳票を取得 |
| ireporter-get-report-detail | 入力帳票の詳細を取得 |
| ireporter-get-cluster-value | 帳票内の単一クラスターの値を取得 |
| ireporter-get-users | ユーザー一覧を取得 |
| ireporter-get-user | ユーザー詳細を取得 |
| ireporter-get-license | ライセンス利用状況を取得 |
| ireporter-list-media | ダウンロード可能な形式を確認 |
| ireporter-download-file | PDF / Excel でエクスポート |

$3

`
get-definitions → get-records → get-report-detail → download-file
`

設定リファレンス

$3

| 環境変数 | CLIフラグ | 説明 |
|----------|----------|------|
| IREPORTER_BASE_URL | --base-url | API の URL。完全パスでも基底URLでも可 |
| IREPORTER_USER_ID | --user | ユーザーID |
| IREPORTER_PASSWORD | --password | パスワード |

$3

| 環境変数 | CLIフラグ | 説明 |
|----------|----------|------|
| IREPORTER_ATTACHMENTS_DIR | --attachments-dir | ダウンロード保存先 |
| IREPORTER_TIMEOUT_MS | --timeout | タイムアウト（デフォルト 30000ms） |
| HTTPS_PROXY | --https-proxy | プロキシURL |
| IREPORTER_ENABLED_CATEGORIES | --enabled-categories | 有効カテゴリ（カンマ区切り） |
| IREPORTER_EXCLUDE_TOOLS | --exclude-tools | 除外ツール名 |

カテゴリ: definition, contelligence, user, license, media

開発

`bash
git clone https://github.com/i-repo-community/ireporter-mcp.git
cd ireporter-mcp
pnpm install
pnpm dev # ウォッチモード起動
pnpm test # テスト実行
pnpm build # ビルド
``

ライセンス

MIT