MCP ITSM統合
Smithery と連携するように設計された、IT サービス管理 (ITSM) ツール用のモデル コンテキスト プロトコル (MCP) 実装。
概要
このプロジェクトは、モデルコンテキストプロトコル（MCP）を用いて、LLMが複数のITSMシステム（ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM、Cherwell）と連携するための統一インターフェースを提供します。この統合により、LLMがITSMシステムごとに異なるAPIを学習する必要がなくなり、すべてのシステムで利用可能な標準化されたツールセットが提供されます。
MCP サーバー情報
これは、モデルコンテキストプロトコル仕様を実装したMCP準拠のサーバーです。大規模言語モデルが統一されたツールセットを通じて複数のITSMシステムと連携するための標準化されたインターフェースを提供します。
MCP互換性
- プロトコルバージョン: MCP 1.0
- ツールフォーマット: JSONスキーマ準拠
- ランタイム: Node.js
- トランスポート: HTTP および stdio
- 認証: APIキー
MCP サーバーの使用状況
サーバーは、以下を含む MCP 互換クライアントで直接使用できます。
- MCP インスペクター CLI ツール
- MCP統合によるクロード
- MCPサポート付きのLLM
サーバーをローカルで検査するには:
npx @modelcontextprotocol/inspector node index.js
特徴
- 統合インターフェース: すべての ITSM システムにわたって一貫したツール定義
- インテリジェントルーティング: リクエストを適切なITSMシステムに自動的にルーティングします
- コンテキスト管理: 対話全体にわたってコンテキストを維持する
- MCP準拠: モデルコンテキストプロトコル仕様に準拠
- Smithery統合: Smitheryとシームレスに連携するように設計されています
前提条件
- Node.js (v14以上)
- スミザリー CLI
- ITSM システムへのアクセス (ServiceNow、Jira、Zendesk、Ivanti Neurons for ITSM、Cherwell)
インストール
- リポジトリをクローンします。
git clone https://github.com/yourusername/mcp-itsm.git
cd mcp-itsm
- 依存関係をインストールします:
- ITSM 資格情報を設定します (構成セクションを参照)
- Smithery にデプロイ:
構成
ITSM資格
ITSM 資格情報を使用して.envファイルを作成します。
# ServiceNow
SERVICENOW_INSTANCE=your-instance
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password
# Jira
JIRA_URL=https://your-instance.atlassian.net
JIRA_USERNAME=your-username
JIRA_API_TOKEN=your-api-token
# Zendesk
ZENDESK_URL=https://your-instance.zendesk.com
ZENDESK_EMAIL=your-email
ZENDESK_API_TOKEN=your-api-token
# Ivanti Neurons for ITSM
IVANTI_URL=https://your-instance.ivanti.com
IVANTI_CLIENT_ID=your-client-id
IVANTI_CLIENT_SECRET=your-client-secret
IVANTI_TENANT_ID=your-tenant-id
# Cherwell
CHERWELL_URL=https://your-instance.cherwell.com
CHERWELL_CLIENT_ID=your-client-id
CHERWELL_AUTH_MODE=internal
CHERWELL_USERNAME=your-username
CHERWELL_PASSWORD=your-password
鍛冶屋の構成
smithery.yamlファイルは、ツールを Smithery にデプロイする方法を構成します。
name: mcp-itsm
description: MCP ITSM Tools for ticket management across multiple systems
version: 1.0.0
tools: ./tools.json
command: node index.js
利用可能なツール
この統合により、次のツールが提供されます。
- create_ticket : 任意のITSMシステムに新しいチケットを作成する
- get_ticket : チケットの詳細を取得する
- update_ticket : 既存のチケットを更新する
- list_tickets : フィルタリングオプション付きのチケットを一覧表示する
- assign_ticket : ユーザーにチケットを割り当てる
- add_comment : チケットにコメントを追加する
- search_knowledge_base : ナレッジベースで関連記事を検索します
完全なツール定義については、 tools.json参照してください。
使用法
Smitheryに導入されると、LLMはこれらのツールを使用してITSMシステムと連携できるようになります。LLMがチケットを作成する例を以下に示します。
User: "I need to report a bug in our accounting software"
LLM: (Makes a tool call)
{
"type": "tool_call",
"data": {
"name": "create_ticket",
"parameters": {
"title": "Bug in accounting software",
"description": "User reported an issue with the accounting software",
"priority": "medium",
"system": "jira"
}
}
}
Response:
{
"type": "tool_response",
"data": {
"name": "create_ticket",
"content": {
"id": "ACCT-123",
"status": "open",
"url": "https://your-instance.atlassian.net/browse/ACCT-123"
}
}
}
デバッグ
このプロジェクトには、いくつかのデバッグ ツールが含まれています。
debug_smithery_mcp.bat : Smithery の MCP 固有の問題を診断しますforce_redeploy_smithery.bat : MCP 構成で強制的に再デプロイメントを実行しますtest_tools.js : MCP ツールの呼び出しをローカルでテストします
ドキュメント
図表
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
リソース