Servicenow

🚀 ServiceNow MCP サーバー

ServiceNowと接続するためのモデルコンテキストプロトコル (MCP) サーバーで、AIエージェントが安全なAPIを通じてServiceNowデータにアクセスし操作できます。このサーバーは自然言語でServiceNowとやり取りでき、記録の検索、データの更新、スクリプトの管理を簡単にします。

🚀 クイックスタート

この ServiceNow MCP サーバーは、AIエージェントが安全なAPIを通じてServiceNowデータにアクセスし操作するためのものです。自然言語でのやり取りをサポートし、記録の検索やデータの更新を容易にします。

✨ 主な機能

リソース

• servicenow://incidents: 最近の障害チケットを一覧表示
• servicenow://incidents/{number}: 番号で特定の障害チケットを取得
• servicenow://users: ユーザー情報を一覧表示
• servicenow://knowledge: ナレッジベースの記事を一覧表示
• servicenow://tables: 利用可能なテーブルを表示
• servicenow://tables/{table}: 指定されたテーブルからレコードを取得
• servicenow://schema/{table}: テーブルのスキーマ情報を取得

ツール

基本ツール

• create_incident: 新しい障害チケットを作成
• update_incident: 既存の障害チケットを更新
• search_records: テキストクエリでレコードを検索
• get_record: sys_idで特定のレコードを取得
• perform_query: ServiceNowクエリを実行
• add_comment: 顧客に表示されるコメントを追加（顧客にのみ表示）
• add_work_notes: 内部作業メモを追加

自然言語ツール

• natural_language_search: 自然言語でレコードを検索（例: すべてのメールに関する障害チケットを検索）
• natural_language_update: 自然言語でレコードを更新（例: 障害チケット INC0010001 を「処理中」に更新）
• update_script: ServiceNowのスクリプトファイルを更新（スクリプト包含、ビジネスルールなど）

📦 インストール

PyPIからのインストール

pip install mcp-server-servicenow

ソースコードからのインストール

git clone https://github.com/michaelbuckner/servicenow-mcp.git
cd servicenow-mcp
pip install -e .

💻 使用例

コマンドラインでの実行

Pythonモジュールを使用してサーバーを起動します。

python -m mcp_server_servicenow.cli --url "https://your-instance.service-now.com/" --username admin --password admin

設定ファイルの使用

config.json という設定ファイルを作成し、以下の内容を記述します。

{
    "instance_url": "https://your-instance.service-now.com/",
    "username": "admin",
    "password": "admin"
}

その後、以下のコマンドを実行します。

python -m mcp_server_servicenow.cli --config config.json

📚 ドキュメント

開発

開発用依存関係のインストール

pip install -e ".[dev]"

テストの実行

pytest

貢献

貢献を歓迎します！自由にPull Requestを送信してください。

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'Add some amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. Pull Requestを送信する

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。