Jenkins MCP Server

Jenkins 2.563用の外部Python MCPサーバーです。JENKINS_USERとJENKINS_API_TOKENで利用可能な権限を使用して、通常のJenkins HTTP API経由で接続します。

Jenkinsの管理者アクセス権は不要で、Jenkinsプラグインのインストールも行わず、公式のJenkins MCP Serverプラグインにも依存しません。

Pythonのセットアップ

このプロジェクトは、ローカルで利用可能な最新の安定版Python 3.14.xを使用してpyenvで初期化されました：

Python: 3.14.4
pyenv virtualenv: venv3144

再現手順：

pyenv local venv3144
python --version
which python
pyenv version

インストール

python -m pip install -e '.[dev]'

環境変数

必須：

export JENKINS_URL="https://jenkins.example.com/"
export JENKINS_USER="your-user"
export JENKINS_API_TOKEN="your-api-token"

任意：

export JENKINS_VERIFY_SSL=1
export JENKINS_TIMEOUT_SECONDS=30
export JENKINS_MCP_MAX_RESPONSE_BYTES=2000000
export JENKINS_MCP_MAX_LOG_BYTES=200000

書き込みゲート：

export JENKINS_MCP_ENABLE_WRITES=1
export JENKINS_MCP_ENABLE_JOB_CONFIG_WRITE=1
export JENKINS_MCP_ENABLE_DELETE=1

MCPクライアントの設定ファイルに実際のJenkinsシークレットを保存しないでください。

STDIOサーバーの実行

python -m jenkins_mcp_server

コンソールスクリプト：

jenkins-mcp-server

クライアントのセットアップ

Codex CLI: docs/codex-setup.md
Gemini CLI: docs/gemini-setup.md

ツール

読み取り専用：

jenkins_whoami
jenkins_version
jenkins_health
jenkins_get_json
jenkins_list_jobs
jenkins_get_job
jenkins_get_job_config
jenkins_list_builds
jenkins_get_build
jenkins_get_build_log
jenkins_get_build_artifacts
jenkins_get_test_report
jenkins_list_queue
jenkins_get_queue_item
jenkins_list_views
jenkins_get_view
jenkins_list_nodes
jenkins_get_node
jenkins_list_plugins

書き込みツール（JENKINS_MCP_ENABLE_WRITES=1で有効化）：

jenkins_trigger_build
jenkins_trigger_build_with_parameters
jenkins_stop_build
jenkins_cancel_queue_item
jenkins_enable_job
jenkins_disable_job

ジョブ設定ツール（JENKINS_MCP_ENABLE_WRITES=1およびJENKINS_MCP_ENABLE_JOB_CONFIG_WRITE=1で有効化）：

jenkins_create_job
jenkins_copy_job
jenkins_update_job_config

削除にはさらにJENKINS_MCP_ENABLE_DELETE=1が必要です：

jenkins_delete_job

安全性

デフォルトで読み取り専用です。
書き込みツールには、明示的なローカル環境フラグとJenkins側の権限が必要です。
Jenkinsのログとジョブの出力は、信頼できないテキストとして扱われます。
APIトークンとAuthorizationヘッダーは、サーバーヘルパーによって出力されません。
401、403、404、Crumbエラー、および権限エラーは、構造化されたエラーとして返されます。

制限事項

スクリプトコンソールはありません。
再起動、安全な再起動、または静止（quiet down）機能はありません。
プラグインのインストール/更新はできません。
認証情報の読み取り/書き込みはできません。
ノードの作成/削除はできません。
グローバル設定の変更はできません。
ユーザー管理はできません。
jenkins_get_test_reportは、testReportを公開するJUnitなどのテストレポートプラグインに依存しており、存在しない場合は明確に失敗します。
ネストされたフォルダーパスは、URLエンコードされたjob/<segment>パスコンポーネントとして繰り返されます。必要なフォルダー/ジョブタイプを持たないコントローラーは、Jenkins 404を返します。

テスト

通常のテストはモック化されており、稼働中のJenkinsコントローラーを必要としません：

python -m pytest
python -m compileall src
ruff check

統合テストは、すべてが設定されている場合にのみ実行されます：

export JENKINS_INTEGRATION_TESTS=1
export JENKINS_URL="https://jenkins.example.com/"
export JENKINS_USER="your-user"
export JENKINS_API_TOKEN="your-api-token"
python -m pytest tests/test_integration.py