fraim-framework 2.0.80 → 2.0.81

package/README.md

@@ -306,9 +306,11 @@ FRAIM uses the official Model Context Protocol (MCP) server for Jira integration
 ```json
 {
   "jira": {
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-jira"],
+    "command": "uvx",
+    "args": ["mcp-atlassian"],
     "env": {
+      "JIRA_URL": "https://mycompany.atlassian.net",
+      "JIRA_USERNAME": "user@mycompany.com",
       "JIRA_API_TOKEN": "your-token-here"
     }
   }
@@ -316,9 +318,9 @@ FRAIM uses the official Model Context Protocol (MCP) server for Jira integration
 ```
 
 **⚠️ Common Issues**:
-- **Old configuration format**: If you see `https://mcp.atlassian.com/v1/sse` in your config, this is incorrect. Run `fraim setup --jira` to update.
+- **Old package name**: If you see `@modelcontextprotocol/server-jira` in your config, this package doesn't exist. Run `fraim setup --jira` to update to the correct `mcp-atlassian` package.
 - **Token format**: Jira API tokens typically start with `ATATT3`. If your token doesn't match this format, verify you created an API token (not a personal access token).
-- **First run slow**: The first time `npx` runs the Jira MCP server, it downloads the package. This is normal and only happens once.
+- **First run slow**: The first time `uvx` runs the Jira MCP server, it downloads the package. This is normal and only happens once.
 
 **Troubleshooting**:
 ```bash

package/dist/src/cli/setup/mcp-config-generator.js

@@ -129,11 +129,11 @@ const generateStandardMCPServers = (fraimKey, tokenInput, jiraConfig) => {
     }
     if (tokens.jira && jiraConfig?.baseUrl && jiraConfig?.email) {
         servers.jira = {
-            command: "npx",
-            args: ["-y", "@modelcontextprotocol/server-jira"],
+            command: "uvx",
+            args: ["mcp-atlassian"],
             env: {
                 JIRA_URL: jiraConfig.baseUrl.startsWith('http') ? jiraConfig.baseUrl : `https://${jiraConfig.baseUrl}`,
-                JIRA_EMAIL: jiraConfig.email,
+                JIRA_USERNAME: jiraConfig.email,
                 JIRA_API_TOKEN: tokens.jira
             }
         };
@@ -184,10 +184,11 @@ const generateClaudeCodeMCPServers = (fraimKey, tokenInput, jiraConfig) => {
             }
         }
     };
-    // Claude Code supports HTTPS MCP servers
+    // Claude Code supports HTTPS MCP servers (uses same format as VSCode)
     if (tokens.github) {
         servers.github = {
-            serverUrl: GITHUB_MCP_URL,
+            type: "http",
+            url: GITHUB_MCP_URL,
             headers: {
                 Authorization: `Bearer ${tokens.github}`
             }
@@ -195,7 +196,8 @@ const generateClaudeCodeMCPServers = (fraimKey, tokenInput, jiraConfig) => {
     }
     if (tokens.gitlab) {
         servers.gitlab = {
-            serverUrl: GITLAB_MCP_URL,
+            type: "http",
+            url: GITLAB_MCP_URL,
             headers: {
                 Authorization: `Bearer ${tokens.gitlab}`
             }
@@ -203,11 +205,11 @@ const generateClaudeCodeMCPServers = (fraimKey, tokenInput, jiraConfig) => {
     }
     if (tokens.jira && jiraConfig?.baseUrl && jiraConfig?.email) {
         servers.jira = {
-            command: "npx",
-            args: ["-y", "@modelcontextprotocol/server-jira"],
+            command: "uvx",
+            args: ["mcp-atlassian"],
             env: {
                 JIRA_URL: jiraConfig.baseUrl.startsWith('http') ? jiraConfig.baseUrl : `https://${jiraConfig.baseUrl}`,
-                JIRA_EMAIL: jiraConfig.email,
+                JIRA_USERNAME: jiraConfig.email,
                 JIRA_API_TOKEN: tokens.jira
             }
         };
@@ -252,11 +254,11 @@ const generateKiroMCPServers = (fraimKey, tokenInput, jiraConfig) => {
     }
     if (tokens.jira && jiraConfig?.baseUrl && jiraConfig?.email) {
         servers.jira = {
-            command: "npx",
-            args: ["-y", "@modelcontextprotocol/server-jira"],
+            command: "uvx",
+            args: ["mcp-atlassian"],
             env: {
                 JIRA_URL: jiraConfig.baseUrl.startsWith('http') ? jiraConfig.baseUrl : `https://${jiraConfig.baseUrl}`,
-                JIRA_EMAIL: jiraConfig.email,
+                JIRA_USERNAME: jiraConfig.email,
                 JIRA_API_TOKEN: tokens.jira
             }
         };
@@ -294,12 +296,12 @@ http_headers = { Authorization = "Bearer ${escapedGitLabToken}" }
         const escapedJiraEmail = escapeTomlString(jiraConfig.email);
         config += `
 [mcp_servers.jira]
-command = "npx"
-args = ["-y", "@modelcontextprotocol/server-jira"]
+command = "uvx"
+args = ["mcp-atlassian"]
 
 [mcp_servers.jira.env]
 JIRA_URL = "${escapedJiraUrl}"
-JIRA_EMAIL = "${escapedJiraEmail}"
+JIRA_USERNAME = "${escapedJiraEmail}"
 JIRA_API_TOKEN = "${escapedJiraToken}"
 `;
     }
@@ -361,11 +363,11 @@ const generateVSCodeMCPServers = (fraimKey, tokenInput, jiraConfig) => {
     if (tokens.jira && jiraConfig?.baseUrl && jiraConfig?.email) {
         servers.jira = {
             type: 'stdio',
-            command: 'npx',
-            args: ['-y', '@modelcontextprotocol/server-jira'],
+            command: 'uvx',
+            args: ['mcp-atlassian'],
             env: {
                 JIRA_URL: jiraConfig.baseUrl.startsWith('http') ? jiraConfig.baseUrl : `https://${jiraConfig.baseUrl}`,
-                JIRA_EMAIL: jiraConfig.email,
+                JIRA_USERNAME: jiraConfig.email,
                 JIRA_API_TOKEN: tokens.jira
             }
         };
@@ -412,11 +414,11 @@ const generateWindsurfMCPServers = (fraimKey, tokenInput, jiraConfig) => {
     }
     if (tokens.jira && jiraConfig?.baseUrl && jiraConfig?.email) {
         servers.jira = {
-            command: 'npx',
-            args: ['-y', '@modelcontextprotocol/server-jira'],
+            command: 'uvx',
+            args: ['mcp-atlassian'],
             env: {
                 JIRA_URL: jiraConfig.baseUrl.startsWith('http') ? jiraConfig.baseUrl : `https://${jiraConfig.baseUrl}`,
-                JIRA_EMAIL: jiraConfig.email,
+                JIRA_USERNAME: jiraConfig.email,
                 JIRA_API_TOKEN: tokens.jira
             }
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "2.0.80",
+  "version": "2.0.81",
   "description": "FRAIM v2: Framework for Rigor-based AI Management - Transform from solo developer to AI manager orchestrating production-ready code with enterprise-grade discipline",
   "main": "index.js",
   "bin": {