Skyenet MCP Ace

🚀 SkyeNet-MCP-ACE

AIエージェント向けServiceNowバックグラウンドスクリプト実行 - モデルコンテキストプロトコル（MCP）サーバーで、AIエージェントがServiceNowインスタンス上でサーバーサイドJavaScriptを直接実行でき、コンテキストの肥大化を軽減する機能を備えています。

🚀 クイックスタート

前提条件

• Node.js 20以上（システム全体にインストールすることを推奨）
• APIアクセス可能なServiceNowインスタンス
• システム全体にインストールするためのroot/sudoアクセス権

インストール

# リポジトリをクローンする
git clone https://github.com/skyenet/skyenet-mcp-ace.git
cd skyenet-mcp-ace

# 万全なデプロイ（すべてのエッジケースを処理）
sudo ./bulletproof-deploy.sh

# インストールを検証する
./bulletproof-verify.sh

設定

ServiceNowの認証情報ファイルを作成します。

# サンプルファイルをコピーする
cp servicenow-ace.env.example ~/.servicenow-ace.env

# ServiceNowの詳細を編集する
nano ~/.servicenow-ace.env

必要な環境変数:

SNOW_INSTANCE=https://your-instance.service-now.com
SNOW_USERNAME=your-username
SNOW_PASSWORD=your-password

Codex統合

Codexの設定ファイル（/etc/codex/config.toml）に追加します。

[[mcp.servers.skyenet-ace]]
command = "/usr/local/sbin/skyenet-mcp-ace-server"
args = []

✨ 主な機能

• コンテキストの肥大化軽減：AIエージェント向けのミニマルモードとクワイエットモード
• 万全なデプロイ：すべてのエッジケースを自動的に処理
• マルチユーザー対応：システム全体のすべてのユーザーに対応
• 包括的な検証：すべてのシナリオをテスト
• ServiceNow統合：エラーハンドリング付きの直接APIアクセス
• 更新セット管理：完全なライフサイクルサポート
• テーブル操作：フィールド検証付きのCRUD操作

📦 インストールガイド

インストール

# リポジトリをクローンする
git clone https://github.com/skyenet/skyenet-mcp-ace.git
cd skyenet-mcp-ace

# 万全なデプロイ（すべてのエッジケースを処理）
sudo ./bulletproof-deploy.sh

# インストールを検証する
./bulletproof-verify.sh

設定

# サンプルファイルをコピーする
cp servicenow-ace.env.example ~/.servicenow-ace.env

# ServiceNowの詳細を編集する
nano ~/.servicenow-ace.env

必要な環境変数:

SNOW_INSTANCE=https://your-instance.service-now.com
SNOW_USERNAME=your-username
SNOW_PASSWORD=your-password

Codex統合

[[mcp.servers.skyenet-ace]]
command = "/usr/local/sbin/skyenet-mcp-ace-server"
args = []

💻 使用例

基本的な使用法

1. execute_background_script

ServiceNowインスタンス上でサーバーサイドJavaScriptを直接実行します。

パラメーター:

• script (文字列): 実行するJavaScriptコード
• quiet (ブール値, オプション): 超最小限のレスポンスモード

例:

// ユーザー情報を取得する
var user = new GlideRecord('sys_user');
user.get('admin');
gs.print(user.getDisplayValue());

2. execute_table_operation

コンテキストの肥大化を軽減しながら、ServiceNowテーブルに対してCRUD操作を実行します。

パラメーター:

• operation (文字列): GET, POST, PUT, DELETE
• table (文字列): テーブル名 (例: 'sys_user', 'incident')
• sys_id (文字列, オプション): 特定の操作に使用するレコードのsys_id
• sys_ids (配列, オプション): バッチ操作に使用する複数のsys_id
• fields (配列, オプション): 取得する特定のフィールド
• query (文字列, オプション): エンコードされたクエリ文字列
• limit (数値, オプション): 返す最大レコード数
• strict_fields (ブール値, オプション): 厳格なフィールド検証を有効にする
• response_mode (文字列, オプション): レスポンスサイズを縮小するための'minimal'

例:

// ユーザーレコードを取得する
{
  "operation": "GET",
  "table": "sys_user",
  "fields": ["sys_id", "user_name", "email"],
  "limit": 10,
  "response_mode": "minimal"
}

// インシデントを作成する
{
  "operation": "POST",
  "table": "incident",
  "data": {
    "short_description": "New incident",
    "priority": "3"
  }
}

3. execute_updateset_operation

コンテキストの肥大化を軽減しながら、ServiceNowの更新セットを管理します。

パラメーター:

• operation (文字列): recent, contents, set_working, get_working
• update_set_sys_id (文字列, オプション): 更新セットのsys_id
• response_mode (文字列, オプション): レスポンスサイズを縮小するための'minimal'
• quiet (ブール値, オプション): 超最小限のレスポンスモード

例:

// 最近のXMLアクティビティを取得する（ミニマルモード）
{
  "operation": "recent",
  "response_mode": "minimal"
}

// 作業中の更新セットを設定する
{
  "operation": "set_working",
  "update_set_sys_id": "abc123def456",
  "quiet": true
}

🔧 技術詳細

コンテキストの肥大化軽減機能

ミニマルモード

• テーブルAPI: 大きなフィールドを切り捨て、レコードを制限し、冗長なデータを削除します。
• 更新セット: 5レコードに制限し、要約をコンパクトにし、構造を扁平化します。
• バックグラウンドスクリプト: 出力を切り捨て、詳細なログを削除します。

クワイエットモード

• 超最小限のレスポンス: 成功/失敗のステータスのみ
• 詳細な出力なし: 必須情報のみ
• トークン使用量の削減: レスポンスサイズを90%以上削減します。

レスポンスサイズの例

• 標準テーブルAPI: ~15KB
• ミニマルテーブルAPI: ~700バイト
• クワイエット更新セット: ~300バイト
• ミニマル更新セット: ~2.6KB

🔄 メンテナンス

インストールの更新

# 最新の変更を取得する
git pull origin main

# 万全なデプロイを再度実行する
sudo ./bulletproof-deploy.sh

# すべてが正常に動作することを検証する
./bulletproof-verify.sh

クリーンな再インストール

# すべてをクリーンアップする
sudo rm -rf /usr/local/lib/node_modules/skyenet-mcp-ace
sudo rm -f /usr/local/sbin/skyenet-mcp-ace-server

# 万全なデプロイを再度実行する
sudo ./bulletproof-deploy.sh

# 検証する
./bulletproof-verify.sh

🚨 トラブルシューティング

サーバーが起動しない場合

# サーバーバイナリを確認する
ls -la /usr/local/sbin/skyenet-mcp-ace-server

# 手動でテストする
/usr/local/sbin/skyenet-mcp-ace-server

# Node.jsのバージョンを確認する
/usr/bin/node --version

Codexのタイムアウト問題

# サーバーが正常に動作することを確認する
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | /usr/local/sbin/skyenet-mcp-ace-server

# Codexの設定を確認する
cat /etc/codex/config.toml | grep skyenet

パーミッション問題

# パーミッションを修正する
sudo chmod +x /usr/local/sbin/skyenet-mcp-ace-server

# 所有者を確認する
sudo chown root:root /usr/local/sbin/skyenet-mcp-ace-server

📊 プロジェクト構造

SkyeNet-MCP-ACE/
├── bulletproof-deploy.sh    # 万全なデプロイスクリプト
├── bulletproof-verify.sh    # 包括的な検証
├── src/                     # TypeScriptソースコード
│   ├── index.ts            # メインのMCPサーバー
│   ├── servicenow/         # ServiceNow統合
│   └── utils/               # ユーティリティ関数
├── build/                  # コンパイルされたJavaScript
└── README.md              # このファイル

🔒 セキュリティ

• 認証情報管理: MCP-Connectとは別に管理
• フィールド検証: インジェクション攻撃を防止
• エラーハンドリング: 安全なエラーレスポンス
• システム全体のインストール: 適切なパーミッション

📈 パフォーマンス

• レスポンス時間: ほとんどの操作で3秒未満
• メモリ使用量: AIエージェントとのやり取りに最適化
• トークン効率: コンテキストの肥大化を90%以上削減
• 信頼性: 万全なデプロイにより安定性を保証

詳細なデプロイ手順については、bulletproofデプロイスクリプトのコメントを参照してください。