@vira_m/jira-mcp-server 1.0.0 → 1.0.2

package/SETUP.md

@@ -0,0 +1,69 @@
+# Jira MCP Server — Инструкции подключения
+
+Пакет: `@vira_m/jira-mcp-server`  
+Инструмент: `get_jira_issue` — получить тикет по ключу (например `PROJ-123`)
+
+---
+
+## Codemie Платформа
+
+1. Открой **Skills** → **Create Skill**
+2. Заполни:
+   - **Skill Name:** `jira-ticket-fetcher`
+   - **Description:** `Use this skill to fetch Jira issues by key from Jira Server`
+   - **Instructions:**
+     ```
+     Use the get_jira_issue tool to fetch a Jira ticket by its key.
+     Always return the full ticket details including summary, status, priority, assignee, and description.
+     ```
+3. В **External tools** добавь MCP сервер:
+   ```json
+   {
+     "command": "npx",
+     "args": ["-y", "@vira_m/jira-mcp-server"],
+     "env": {
+       "JIRA_BASE_URL": "https://jira.yourcompany.com",
+       "JIRA_PAT": "your_personal_access_token"
+     }
+   }
+   ```
+4. Нажми **Create Skill**
+5. Прикрепи скил к нужному ассистенту: **Assistants** → выбери ассистента → **Edit** → **Skills** → добавь `jira-ticket-fetcher`
+
+---
+
+## Codemie Code (локально)
+
+Открой конфиг MCP (обычно `~/.codemie/mcp.json` или через `ctrl+p` → MCP Settings) и добавь:
+
+```json
+{
+  "mcpServers": {
+    "jira": {
+      "command": "npx",
+      "args": ["-y", "@vira_m/jira-mcp-server"],
+      "env": {
+        "JIRA_BASE_URL": "https://jira.yourcompany.com",
+        "JIRA_PAT": "your_personal_access_token"
+      }
+    }
+  }
+}
+```
+
+Перезапусти Codemie Code — инструмент `get_jira_issue` станет доступен.
+
+---
+
+## Использование
+
+После подключения просто напиши ассистенту:
+```
+Покажи тикет PROJ-123
+```
+
+или
+
+```
+Fetch Jira issue PROJ-456
+```

package/dist/index.js

@@ -2,12 +2,9 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import axios from "axios";
 import { z } from "zod";
-const JIRA_BASE_URL = process.env.JIRA_BASE_URL;
-const JIRA_PAT = process.env.JIRA_PAT;
-if (!JIRA_BASE_URL || !JIRA_PAT) {
-    console.error("Missing JIRA_BASE_URL or JIRA_PAT environment variables");
-    process.exit(1);
-}
+// Support both direct env vars (local) and Codemie platform integration env vars
+const JIRA_BASE_URL = process.env.JIRA_BASE_URL || process.env.url;
+const JIRA_PAT = process.env.JIRA_PAT || process.env.token;
 const jira = axios.create({
     baseURL: `${JIRA_BASE_URL}/rest/api/2`,
     headers: {
@@ -19,6 +16,10 @@ const server = new McpServer({
     name: "jira-mcp-server",
     version: "1.0.0",
 });
+server.tool("debug_env", "Debug: show which env variables are set (keys only, no values)", {}, async () => {
+    const keys = Object.keys(process.env).sort();
+    return { content: [{ type: "text", text: keys.join("\n") }] };
+});
 server.tool("get_jira_issue", "Fetch a Jira issue by its key (e.g. PROJ-123)", { issue_key: z.string().describe("Jira issue key, e.g. PROJ-123") }, async ({ issue_key }) => {
     const { data } = await jira.get(`/issue/${issue_key}`);
     const f = data.fields;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vira_m/jira-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for fetching Jira issues",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -3,13 +3,9 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import axios from "axios";
 import { z } from "zod";
 
-const JIRA_BASE_URL = process.env.JIRA_BASE_URL!;
-const JIRA_PAT = process.env.JIRA_PAT!;
-
-if (!JIRA_BASE_URL || !JIRA_PAT) {
-  console.error("Missing JIRA_BASE_URL or JIRA_PAT environment variables");
-  process.exit(1);
-}
+// Support both direct env vars (local) and Codemie platform integration env vars
+const JIRA_BASE_URL = process.env.JIRA_BASE_URL || process.env.url;
+const JIRA_PAT = process.env.JIRA_PAT || process.env.token;
 
 const jira = axios.create({
   baseURL: `${JIRA_BASE_URL}/rest/api/2`,
@@ -24,6 +20,16 @@ const server = new McpServer({
   version: "1.0.0",
 });
 
+server.tool(
+  "debug_env",
+  "Debug: show which env variables are set (keys only, no values)",
+  {},
+  async () => {
+    const keys = Object.keys(process.env).sort();
+    return { content: [{ type: "text", text: keys.join("\n") }] };
+  }
+);
+
 server.tool(
   "get_jira_issue",
   "Fetch a Jira issue by its key (e.g. PROJ-123)",