MCP Jira REST 9.14.0 (Opencode compatible)

Serveur MCP Jira en stdio, compatible OpenCode, avec configuration minimale via .env.

Objectif

• API cible: Jira REST 9.14.0 (base /rest/api/2)
• Authentification: Basic Auth (user + password)
• Configuration: variables .env (user / mdp / urlapi + options SSL/tools)
• Transport MCP: stdio (compatibilité OpenCode via type: "local")

Installation rapide (sans clone)

Avec le package npm publié:

npx -y mcp-jira-rest914

Le binaire CLI exposé est mcp-jira-rest914.

Pour un usage local développeur (ce repo):

npm install

Configuration .env

Copiez .env.example vers .env puis remplissez:

JIRA_USER=your-user
JIRA_PASSWORD=your-password
JIRA_API_URL=https://your-jira.example.com
JIRA_SSL_VERIFY=true
MCP_TOOL_ALLOWLIST=

Vous pouvez aussi utiliser les alias demandés (USER, MDP, URLAPI) si vous préférez.

Options:

• JIRA_SSL_VERIFY=false: désactive la vérification SSL/TLS (utile en certificat auto-signé)
• MCP_TOOL_ALLOWLIST: liste CSV des tools MCP autorisés (ex: jira_get_issue,jira_request)
  • vide: tous les tools sont exposés
  • *: tous les tools sont exposés explicitement

Développement et build

npm run check
npm run build
npm run dev

Tools MCP exposés

• jira_get_issue
• jira_search_issues
• jira_create_issue
• jira_update_issue
• jira_list_issue_transitions
• jira_transition_issue
• jira_add_comment
• jira_list_projects
• jira_get_server_info
• jira_request (générique, pour couvrir toute l’API)

jira_request permet d'appeler n'importe quel endpoint Jira REST 9.14.0 avec method + path + query + body.

Compatibilité OpenCode

Exemple de configuration OpenCode (~/.config/opencode/opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jira": {
      "type": "local",
      "enabled": true,
      "command": ["npx", "-y", "mcp-jira-rest914"]
    }
  }
}

Pas de chemin absolu requis.

Important: .env doit etre disponible dans le dossier de travail d'OpenCode (ou variables exportées dans l'environnement).

Publication GitHub (public)

git init
git add .
git commit -m "feat: initial MCP Jira REST 9.14 server"
git branch -M main
git remote add origin [email protected]:<your-org-or-user>/mcp-jira-rest914.git
git push -u origin main

Publication npm (pour npx)

npm login
npm publish --access public

Mise a jour:

npm version patch
npm publish --access public

Notes Jira

• Si JIRA_API_URL ne contient pas /rest/api/*, le serveur ajoute automatiquement /rest/api/2.
• Si vous passez un path commençant par /rest/... dans jira_request, ce path est utilisé tel quel.
• JIRA_SSL_VERIFY=false applique NODE_TLS_REJECT_UNAUTHORIZED=0 au process (à utiliser seulement si nécessaire).