Jira MCP Server

Instructions

Implementation Reference

• src/server.ts:56-144 (handler)

  The handler function for the 'get_jira_issue' tool. Fetches the Jira issue using the REST API, parses key fields (summary, status, assignee, etc.), cleans the description, and returns formatted text content along with structured data including a URL to the issue.

    async (args: { issueKey: string }) => {
      try {
        const url = `${JIRA_URL}/rest/api/3/issue/${args.issueKey}`;
        const response = await fetch(url, {
          method: "GET",
          headers: getJiraHeaders(),
        });
  
        if (!response.ok) {
          const errorText = await response.text();
          return {
            content: [
              {
                type: "text",
                text: `Failed to fetch Jira issue ${args.issueKey}: ${response.status} ${response.statusText}\n${errorText}`,
              },
            ],
            isError: true,
          };
        }
  
        const issueData = await response.json() as any;
        
        // Extract key information from the issue
        const issue = issueData;
        const fields = issue.fields;
        
        const summary = fields.summary || 'No summary';
        const description = fields.description || 'No description';
        const status = fields.status?.name || 'Unknown status';
        const assignee = fields.assignee?.displayName || 'Unassigned';
        const reporter = fields.reporter?.displayName || 'Unknown reporter';
        const priority = fields.priority?.name || 'No priority';
        const issueType = fields.issuetype?.name || 'Unknown type';
        const created = fields.created ? new Date(fields.created).toLocaleDateString() : 'Unknown';
        const updated = fields.updated ? new Date(fields.updated).toLocaleDateString() : 'Unknown';
        
        // Format description (remove HTML tags if present)
        const cleanDescription = typeof description === 'string' 
          ? description.replace(/<[^>]*>/g, '').trim()
          : JSON.stringify(description);
  
        return {
          content: [
            {
              type: "text",
              text: `**${issue.key}: ${summary}**
  
  **Status:** ${status}
  **Type:** ${issueType}
  **Priority:** ${priority}
  **Assignee:** ${assignee}
  **Reporter:** ${reporter}
  **Created:** ${created}
  **Updated:** ${updated}
  
  **Description:**
  ${cleanDescription}
  
  **Full Issue Data:** Available in structured content below.`,
            },
          ],
          structuredContent: {
            issueKey: issue.key,
            summary,
            description: cleanDescription,
            status,
            issueType,
            priority,
            assignee,
            reporter,
            created,
            updated,
            url: `${JIRA_URL}/browse/${issue.key}`,
            fullData: issueData,
          },
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error fetching Jira issue ${args.issueKey}: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
          isError: true,
        };
      }
    }

• src/server.ts:49-54 (schema)

  Schema definition for the 'get_jira_issue' tool, including title, description, and input schema requiring 'issueKey' as a string.

  {
    title: "Get Jira Issue",
    description: "Get detailed information about a Jira issue by its key (e.g., PROJ-123)",
    inputSchema: {
      issueKey: z.string().describe("The Jira issue key (e.g., PROJ-123, TASK-456)"),
    },

• src/server.ts:47-145 (registration)

  Registration of the 'get_jira_issue' tool with the MCP server using mcp.registerTool, passing the tool name, schema, and inline handler function.

  mcp.registerTool(
    "get_jira_issue",
    {
      title: "Get Jira Issue",
      description: "Get detailed information about a Jira issue by its key (e.g., PROJ-123)",
      inputSchema: {
        issueKey: z.string().describe("The Jira issue key (e.g., PROJ-123, TASK-456)"),
      },
    },
    async (args: { issueKey: string }) => {
      try {
        const url = `${JIRA_URL}/rest/api/3/issue/${args.issueKey}`;
        const response = await fetch(url, {
          method: "GET",
          headers: getJiraHeaders(),
        });
  
        if (!response.ok) {
          const errorText = await response.text();
          return {
            content: [
              {
                type: "text",
                text: `Failed to fetch Jira issue ${args.issueKey}: ${response.status} ${response.statusText}\n${errorText}`,
              },
            ],
            isError: true,
          };
        }
  
        const issueData = await response.json() as any;
        
        // Extract key information from the issue
        const issue = issueData;
        const fields = issue.fields;
        
        const summary = fields.summary || 'No summary';
        const description = fields.description || 'No description';
        const status = fields.status?.name || 'Unknown status';
        const assignee = fields.assignee?.displayName || 'Unassigned';
        const reporter = fields.reporter?.displayName || 'Unknown reporter';
        const priority = fields.priority?.name || 'No priority';
        const issueType = fields.issuetype?.name || 'Unknown type';
        const created = fields.created ? new Date(fields.created).toLocaleDateString() : 'Unknown';
        const updated = fields.updated ? new Date(fields.updated).toLocaleDateString() : 'Unknown';
        
        // Format description (remove HTML tags if present)
        const cleanDescription = typeof description === 'string' 
          ? description.replace(/<[^>]*>/g, '').trim()
          : JSON.stringify(description);
  
        return {
          content: [
            {
              type: "text",
              text: `**${issue.key}: ${summary}**
  
  **Status:** ${status}
  **Type:** ${issueType}
  **Priority:** ${priority}
  **Assignee:** ${assignee}
  **Reporter:** ${reporter}
  **Created:** ${created}
  **Updated:** ${updated}
  
  **Description:**
  ${cleanDescription}
  
  **Full Issue Data:** Available in structured content below.`,
            },
          ],
          structuredContent: {
            issueKey: issue.key,
            summary,
            description: cleanDescription,
            status,
            issueType,
            priority,
            assignee,
            reporter,
            created,
            updated,
            url: `${JIRA_URL}/browse/${issue.key}`,
            fullData: issueData,
          },
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error fetching Jira issue ${args.issueKey}: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/server.ts:37-44 (helper)

  Helper function getJiraHeaders() that creates authentication headers for Jira API requests, used in the get_jira_issue handler and other tools.

  function getJiraHeaders(): Record<string, string> {
    const auth = Buffer.from(`${JIRA_EMAIL}:${JIRA_API_TOKEN}`).toString('base64');
    return {
      'Authorization': `Basic ${auth}`,
      'Accept': 'application/json',
      'Content-Type': 'application/json',
    };
  }