MCP FOR ITSM

by madosh
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides integration with Atlassian products (beyond Jira) through a unified interface, handling authentication and API interactions.

  • Enables interaction with Jira instances through a unified API, providing capabilities for accessing issues, managing tickets, and integrating with Jira workflows.

  • Allows connection to Zendesk instances to manage tickets and support requests through a standardized interface that abstracts away Zendesk-specific API complexities.

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)

インストール

  1. リポジトリをクローンします。
    git clone https://github.com/yourusername/mcp-itsm.git cd mcp-itsm
  2. 依存関係をインストールします:
    npm install
  3. ITSM 資格情報を設定します (構成セクションを参照)
  4. Smithery にデプロイ:
    smithery deploy

構成

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 ファイルを参照してください。

リソース

ID: hud80wep9g