Jira MCP Server R17

🚀 Jira サーバー

Jiraサーバーは、JiraのREST APIを利用して、Jiraイシューの作成、更新、取得などの操作を行うことができるサーバーアプリケーションです。

🚀 クイックスタート

インストールと設定

1. リポジトリをクローンする

   git clone https://github.com/your-repository.git
   cd jira-server
   

2. 依存関係をインストールする

   npm install
   

3. 環境変数を設定する

   • .env ファイルを作成し、以下の内容を追加します。

     JIRA_HOST=あなたのJiraインスタンスのアドレス
     JIRA_EMAIL=あなたのJiraメールアドレス
     JIRA_API_TOKEN=あなたのJira APIトークン
     

4. サーバーを起動する

   npm start
   

主な機能

問題を作成する

{
  "issue": {
    "fields": {
      "summary": "問題のタイトル",
      "description": "問題の説明",
      "status": "未解決",
      "priority": "高優先度",
      "assignee": { "id": "ユーザーID" },
      "issuetype": { "id": "問題のタイプID" }
    }
  }
} 

問題を更新する

{
  "issueKey": "プロジェクト-123",
  "fields": {
    "summary": "新しいタイトル",
    "status": "解決済み"
  }
}

📚 ドキュメント

問題のリストを取得する

curl --user ${JIRA_EMAIL}:${JIRA_API_TOKEN} \
     --header "Content-Type: application/json" \
     --request GET \
     "https://${JIRA_HOST}/rest/api/2/search?jql=project%20=%22プロジェクト名%22"

単一の問題を取得する

curl --user ${JIRA_EMAIL}:${JIRA_API_TOKEN} \
     --header "Content-Type: application/json" \
     --request GET \
     "https://${JIRA_HOST}/rest/api/2/issue/プロジェクト-123"

🔧 高度な機能

一括操作

複数の問題を作成する

{
  "issues": [
    {
      "fields": {
        "summary": "問題1",
        "description": "説明1"
      }
    },
    {
      "fields": {
        "summary": "問題2",
        "description": "説明2"
      }
    }
  ]
}

複数の問題を更新する

{
  "issueKeys": ["プロジェクト-123", "プロジェクト-124"],
  "fields": {
    "status": "解決済み"
  }
}

🛠️ カスタム設定

カスタムフィールド

JIRA_CUSTOM_FIELDS 環境変数でカスタムフィールドを指定します。

JIRA_CUSTOM_FIELDS=summary,description,status,priority,assignee,issuetype

リクエストの例

カスタムフィールドを含めて問題を作成する

{
  "issue": {
    "fields": {
      "customfield_12345": "カスタム値",
      "priority": { "id": "P1" }
    }
  }
}

🤝 貢献ガイド

コードを提出する

1. 機能ブランチを作成する

   git checkout -b feature/新しい機能
   

2. 変更をコミットする

   git add .
   git commit -m "新しい機能を追加"
   git push origin feature/新しい機能
   

3. プルリクエストを作成する

   • GitHubリポジトリ にアクセスします。
   • "New Pull Request" をクリックします。
   • 関連情報を入力して送信します。

コードスタイル

• JavaScript標準 に従います。
• 意味のある変数名を使用します。
• コードの可読性に配慮します。

📖 参考資料

• Jira REST API: 公式ドキュメント
• Node.js: 公式ウェブサイト
• npm: パッケージマネージャー

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。
Copyright (c) 2023, Your Name.