issue-scribe-mcp 1.0.0

package/.env.example

@@ -0,0 +1 @@
+GITHUB_TOKEN=your_github_token_here

package/README.md

@@ -0,0 +1,97 @@
+# issue-scribe-mcp
+
+GitHub Issue/PR 컨텍스트를 수집하는 MCP 서버
+
+## 설치
+
+```bash
+npm install -g issue-scribe-mcp
+```
+
+## 로컬 개발
+
+```bash
+# 의존성 설치
+npm install
+
+# 빌드
+npm run build
+
+# 환경변수 설정
+export GITHUB_TOKEN=your_github_token_here
+
+# 직접 실행
+node dist/index.js
+```
+
+## MCP 클라이언트 설정
+
+Claude Desktop 등의 MCP 클라이언트에서 사용:
+
+```json
+{
+  "mcpServers": {
+    "issue-scribe": {
+      "command": "node",
+      "args": ["/path/to/issue-scribe-mcp/dist/index.js"],
+      "env": {
+        "GITHUB_TOKEN": "your_github_token_here"
+      }
+    }
+  }
+}
+```
+
+## 제공 Tools
+
+### github_get_issue_context
+GitHub Issue의 전체 컨텍스트 조회
+
+- owner: 저장소 소유자
+- repo: 저장소 이름
+- issue_number: 이슈 번호
+
+### github_get_pr_context
+GitHub Pull Request의 전체 컨텍스트 조회 (커밋 포함)
+
+- owner: 저장소 소유자
+- repo: 저장소 이름
+- pull_number: PR 번호
+
+### github_create_issue
+새로운 GitHub Issue 생성
+
+- owner: 저장소 소유자
+- repo: 저장소 이름
+- title: 이슈 제목 (필수)
+- body: 이슈 본문 (옵션)
+- labels: 라벨 배열 (옵션)
+- assignees: 담당자 배열 (옵션)
+
+### github_update_issue
+기존 GitHub Issue 수정
+
+- owner: 저장소 소유자
+- repo: 저장소 이름
+- issue_number: 이슈 번호
+- title: 새 제목 (옵션)
+- body: 새 본문 (옵션)
+- state: "open" 또는 "closed" (옵션)
+- labels: 새 라벨 배열 (옵션)
+- assignees: 새 담당자 배열 (옵션)
+
+### github_create_pr
+새로운 GitHub Pull Request 생성
+
+- owner: 저장소 소유자
+- repo: 저장소 이름
+- title: PR 제목 (필수)
+- body: PR 설명 (옵션)
+- head: 병합할 브랜치 (필수, 예: "feature-branch")
+- base: 병합 대상 브랜치 (필수, 예: "main")
+- draft: Draft PR로 생성 (옵션)
+- maintainer_can_modify: 메인테이너 수정 허용 (옵션)
+
+## 라이선스
+
+ISC

package/dist/index.js

@@ -0,0 +1,421 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { Octokit } from "@octokit/rest";
+import { z } from "zod";
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
+if (!GITHUB_TOKEN) {
+    console.error("Error: GITHUB_TOKEN environment variable is required");
+    process.exit(1);
+}
+const octokit = new Octokit({ auth: GITHUB_TOKEN });
+const GetIssueSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    issue_number: z.number(),
+});
+const GetPRSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    pull_number: z.number(),
+});
+const CreateIssueSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    title: z.string(),
+    body: z.string().optional(),
+    labels: z.array(z.string()).optional(),
+    assignees: z.array(z.string()).optional(),
+});
+const UpdateIssueSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    issue_number: z.number(),
+    title: z.string().optional(),
+    body: z.string().optional(),
+    state: z.enum(["open", "closed"]).optional(),
+    labels: z.array(z.string()).optional(),
+    assignees: z.array(z.string()).optional(),
+});
+const CreatePRSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    title: z.string(),
+    body: z.string().optional(),
+    head: z.string(), // branch to merge FROM (e.g., "feature-branch")
+    base: z.string(), // branch to merge INTO (e.g., "main")
+    draft: z.boolean().optional(),
+    maintainer_can_modify: z.boolean().optional(),
+});
+const server = new Server({
+    name: "issue-scribe-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "github_get_issue_context",
+                description: "Get GitHub Issue context including title, body, comments, and metadata",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        issue_number: { type: "number", description: "Issue number" },
+                    },
+                    required: ["owner", "repo", "issue_number"],
+                },
+            },
+            {
+                name: "github_get_pr_context",
+                description: "Get GitHub Pull Request context including title, body, comments, commits, and metadata",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        pull_number: { type: "number", description: "Pull request number" },
+                    },
+                    required: ["owner", "repo", "pull_number"],
+                },
+            },
+            {
+                name: "github_create_issue",
+                description: "Create a new GitHub Issue",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        title: { type: "string", description: "Issue title" },
+                        body: { type: "string", description: "Issue body (optional)" },
+                        labels: { type: "array", items: { type: "string" }, description: "Labels to add (optional)" },
+                        assignees: { type: "array", items: { type: "string" }, description: "Assignees (optional)" },
+                    },
+                    required: ["owner", "repo", "title"],
+                },
+            },
+            {
+                name: "github_update_issue",
+                description: "Update an existing GitHub Issue",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        issue_number: { type: "number", description: "Issue number" },
+                        title: { type: "string", description: "New title (optional)" },
+                        body: { type: "string", description: "New body (optional)" },
+                        state: { type: "string", enum: ["open", "closed"], description: "Issue state (optional)" },
+                        labels: { type: "array", items: { type: "string" }, description: "New labels (optional)" },
+                        assignees: { type: "array", items: { type: "string" }, description: "New assignees (optional)" },
+                    },
+                    required: ["owner", "repo", "issue_number"],
+                },
+            },
+            {
+                name: "github_create_pr",
+                description: "Create a new GitHub Pull Request",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        title: { type: "string", description: "PR title" },
+                        body: { type: "string", description: "PR body/description (optional)" },
+                        head: { type: "string", description: "Branch to merge FROM (e.g., 'feature-branch')" },
+                        base: { type: "string", description: "Branch to merge INTO (e.g., 'main')" },
+                        draft: { type: "boolean", description: "Create as draft PR (optional)" },
+                        maintainer_can_modify: { type: "boolean", description: "Allow maintainer edits (optional)" },
+                    },
+                    required: ["owner", "repo", "title", "head", "base"],
+                },
+            },
+        ],
+    };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (name === "github_get_issue_context") {
+        try {
+            const { owner, repo, issue_number } = GetIssueSchema.parse(args);
+            const [issue, comments] = await Promise.all([
+                octokit.rest.issues.get({ owner, repo, issue_number }),
+                octokit.rest.issues.listComments({ owner, repo, issue_number }),
+            ]);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            issue: {
+                                number: issue.data.number,
+                                title: issue.data.title,
+                                body: issue.data.body,
+                                state: issue.data.state,
+                                user: issue.data.user?.login,
+                                created_at: issue.data.created_at,
+                                updated_at: issue.data.updated_at,
+                                labels: issue.data.labels.map((l) => typeof l === "string" ? l : l.name),
+                            },
+                            comments: comments.data.map((c) => ({
+                                user: c.user?.login,
+                                body: c.body,
+                                created_at: c.created_at,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const issueNum = args && typeof args === 'object' && 'issue_number' in args ? args.issue_number : 'unknown';
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to fetch issue #${issueNum} from ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    if (name === "github_get_pr_context") {
+        try {
+            const { owner, repo, pull_number } = GetPRSchema.parse(args);
+            const [pr, comments, commits] = await Promise.all([
+                octokit.rest.pulls.get({ owner, repo, pull_number }),
+                octokit.rest.issues.listComments({ owner, repo, issue_number: pull_number }),
+                octokit.rest.pulls.listCommits({ owner, repo, pull_number }),
+            ]);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            pull_request: {
+                                number: pr.data.number,
+                                title: pr.data.title,
+                                body: pr.data.body,
+                                state: pr.data.state,
+                                user: pr.data.user?.login,
+                                created_at: pr.data.created_at,
+                                updated_at: pr.data.updated_at,
+                                merged_at: pr.data.merged_at,
+                                base: pr.data.base.ref,
+                                head: pr.data.head.ref,
+                                labels: pr.data.labels.map((l) => typeof l === "string" ? l : l.name),
+                            },
+                            comments: comments.data.map((c) => ({
+                                user: c.user?.login,
+                                body: c.body,
+                                created_at: c.created_at,
+                            })),
+                            commits: commits.data.map((c) => ({
+                                sha: c.sha,
+                                message: c.commit.message,
+                                author: c.commit.author?.name,
+                                date: c.commit.author?.date,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const pullNum = args && typeof args === 'object' && 'pull_number' in args ? args.pull_number : 'unknown';
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to fetch PR #${pullNum} from ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    if (name === "github_create_issue") {
+        try {
+            const { owner, repo, title, body, labels, assignees } = CreateIssueSchema.parse(args);
+            const issue = await octokit.rest.issues.create({
+                owner,
+                repo,
+                title,
+                body,
+                labels,
+                assignees,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            issue: {
+                                number: issue.data.number,
+                                title: issue.data.title,
+                                state: issue.data.state,
+                                html_url: issue.data.html_url,
+                                created_at: issue.data.created_at,
+                            },
+                            message: `Issue #${issue.data.number} created successfully`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            const title = args && typeof args === 'object' && 'title' in args ? args.title : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to create issue "${title}" in ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    if (name === "github_update_issue") {
+        try {
+            const { owner, repo, issue_number, title, body, state, labels, assignees } = UpdateIssueSchema.parse(args);
+            const issue = await octokit.rest.issues.update({
+                owner,
+                repo,
+                issue_number,
+                title,
+                body,
+                state,
+                labels,
+                assignees,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            issue: {
+                                number: issue.data.number,
+                                title: issue.data.title,
+                                state: issue.data.state,
+                                html_url: issue.data.html_url,
+                                updated_at: issue.data.updated_at,
+                            },
+                            message: `Issue #${issue.data.number} updated successfully`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const issueNum = args && typeof args === 'object' && 'issue_number' in args ? args.issue_number : 'unknown';
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to update issue #${issueNum} in ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    if (name === "github_create_pr") {
+        try {
+            const { owner, repo, title, body, head, base, draft, maintainer_can_modify } = CreatePRSchema.parse(args);
+            const pr = await octokit.rest.pulls.create({
+                owner,
+                repo,
+                title,
+                body,
+                head,
+                base,
+                draft,
+                maintainer_can_modify,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            pull_request: {
+                                number: pr.data.number,
+                                title: pr.data.title,
+                                state: pr.data.state,
+                                html_url: pr.data.html_url,
+                                draft: pr.data.draft,
+                                head: pr.data.head.ref,
+                                base: pr.data.base.ref,
+                                created_at: pr.data.created_at,
+                            },
+                            message: `PR #${pr.data.number} created successfully`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            const title = args && typeof args === 'object' && 'title' in args ? args.title : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to create PR "${title}" in ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    throw new Error(`Unknown tool: ${name}`);
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("issue-scribe-mcp server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "issue-scribe-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for GitHub Issue/PR context aggregation",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "issue-scribe-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gay00ung/issue-scribe-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "github",
+    "issue",
+    "pr"
+  ],
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/gay00ung/issue-scribe-mcp/issues"
+  },
+  "homepage": "https://github.com/gay00ung/issue-scribe-mcp#readme",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@octokit/rest": "^22.0.1",
+    "dotenv": "^17.2.3",
+    "settings": "^0.1.1",
+    "zod": "^4.2.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,476 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+    CallToolRequestSchema,
+    ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { Octokit } from "@octokit/rest";
+import { z } from "zod";
+
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
+
+if (!GITHUB_TOKEN) {
+    console.error("Error: GITHUB_TOKEN environment variable is required");
+    process.exit(1);
+}
+
+const octokit = new Octokit({ auth: GITHUB_TOKEN });
+
+const GetIssueSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    issue_number: z.number(),
+});
+
+const GetPRSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    pull_number: z.number(),
+});
+
+const CreateIssueSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    title: z.string(),
+    body: z.string().optional(),
+    labels: z.array(z.string()).optional(),
+    assignees: z.array(z.string()).optional(),
+});
+
+const UpdateIssueSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    issue_number: z.number(),
+    title: z.string().optional(),
+    body: z.string().optional(),
+    state: z.enum(["open", "closed"]).optional(),
+    labels: z.array(z.string()).optional(),
+    assignees: z.array(z.string()).optional(),
+});
+
+const CreatePRSchema = z.object({
+    owner: z.string(),
+    repo: z.string(),
+    title: z.string(),
+    body: z.string().optional(),
+    head: z.string(), // branch to merge FROM (e.g., "feature-branch")
+    base: z.string(), // branch to merge INTO (e.g., "main")
+    draft: z.boolean().optional(),
+    maintainer_can_modify: z.boolean().optional(),
+});
+
+const server = new Server(
+    {
+        name: "issue-scribe-mcp",
+        version: "1.0.0",
+    },
+    {
+        capabilities: {
+            tools: {},
+        },
+    }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "github_get_issue_context",
+                description: "Get GitHub Issue context including title, body, comments, and metadata",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        issue_number: { type: "number", description: "Issue number" },
+                    },
+                    required: ["owner", "repo", "issue_number"],
+                },
+            },
+            {
+                name: "github_get_pr_context",
+                description: "Get GitHub Pull Request context including title, body, comments, commits, and metadata",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        pull_number: { type: "number", description: "Pull request number" },
+                    },
+                    required: ["owner", "repo", "pull_number"],
+                },
+            },
+            {
+                name: "github_create_issue",
+                description: "Create a new GitHub Issue",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        title: { type: "string", description: "Issue title" },
+                        body: { type: "string", description: "Issue body (optional)" },
+                        labels: { type: "array", items: { type: "string" }, description: "Labels to add (optional)" },
+                        assignees: { type: "array", items: { type: "string" }, description: "Assignees (optional)" },
+                    },
+                    required: ["owner", "repo", "title"],
+                },
+            },
+            {
+                name: "github_update_issue",
+                description: "Update an existing GitHub Issue",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        issue_number: { type: "number", description: "Issue number" },
+                        title: { type: "string", description: "New title (optional)" },
+                        body: { type: "string", description: "New body (optional)" },
+                        state: { type: "string", enum: ["open", "closed"], description: "Issue state (optional)" },
+                        labels: { type: "array", items: { type: "string" }, description: "New labels (optional)" },
+                        assignees: { type: "array", items: { type: "string" }, description: "New assignees (optional)" },
+                    },
+                    required: ["owner", "repo", "issue_number"],
+                },
+            },
+            {
+                name: "github_create_pr",
+                description: "Create a new GitHub Pull Request",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        owner: { type: "string", description: "Repository owner" },
+                        repo: { type: "string", description: "Repository name" },
+                        title: { type: "string", description: "PR title" },
+                        body: { type: "string", description: "PR body/description (optional)" },
+                        head: { type: "string", description: "Branch to merge FROM (e.g., 'feature-branch')" },
+                        base: { type: "string", description: "Branch to merge INTO (e.g., 'main')" },
+                        draft: { type: "boolean", description: "Create as draft PR (optional)" },
+                        maintainer_can_modify: { type: "boolean", description: "Allow maintainer edits (optional)" },
+                    },
+                    required: ["owner", "repo", "title", "head", "base"],
+                },
+            },
+        ],
+    };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    if (name === "github_get_issue_context") {
+        try {
+            const { owner, repo, issue_number } = GetIssueSchema.parse(args);
+
+            const [issue, comments] = await Promise.all([
+                octokit.rest.issues.get({ owner, repo, issue_number }),
+                octokit.rest.issues.listComments({ owner, repo, issue_number }),
+            ]);
+
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(
+                            {
+                                issue: {
+                                    number: issue.data.number,
+                                    title: issue.data.title,
+                                    body: issue.data.body,
+                                    state: issue.data.state,
+                                    user: issue.data.user?.login,
+                                    created_at: issue.data.created_at,
+                                    updated_at: issue.data.updated_at,
+                                    labels: issue.data.labels.map((l: any) =>
+                                        typeof l === "string" ? l : l.name
+                                    ),
+                                },
+                                comments: comments.data.map((c) => ({
+                                    user: c.user?.login,
+                                    body: c.body,
+                                    created_at: c.created_at,
+                                })),
+                            },
+                            null,
+                            2
+                        ),
+                    },
+                ],
+            };
+        } catch (error: any) {
+            const issueNum = args && typeof args === 'object' && 'issue_number' in args ? args.issue_number : 'unknown';
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to fetch issue #${issueNum} from ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+
+    if (name === "github_get_pr_context") {
+        try {
+            const { owner, repo, pull_number } = GetPRSchema.parse(args);
+
+            const [pr, comments, commits] = await Promise.all([
+                octokit.rest.pulls.get({ owner, repo, pull_number }),
+                octokit.rest.issues.listComments({ owner, repo, issue_number: pull_number }),
+                octokit.rest.pulls.listCommits({ owner, repo, pull_number }),
+            ]);
+
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(
+                            {
+                                pull_request: {
+                                    number: pr.data.number,
+                                    title: pr.data.title,
+                                    body: pr.data.body,
+                                    state: pr.data.state,
+                                    user: pr.data.user?.login,
+                                    created_at: pr.data.created_at,
+                                    updated_at: pr.data.updated_at,
+                                    merged_at: pr.data.merged_at,
+                                    base: pr.data.base.ref,
+                                    head: pr.data.head.ref,
+                                    labels: pr.data.labels.map((l: any) =>
+                                        typeof l === "string" ? l : l.name
+                                    ),
+                                },
+                                comments: comments.data.map((c) => ({
+                                    user: c.user?.login,
+                                    body: c.body,
+                                    created_at: c.created_at,
+                                })),
+                                commits: commits.data.map((c) => ({
+                                    sha: c.sha,
+                                    message: c.commit.message,
+                                    author: c.commit.author?.name,
+                                    date: c.commit.author?.date,
+                                })),
+                            },
+                            null,
+                            2
+                        ),
+                    },
+                ],
+            };
+        } catch (error: any) {
+            const pullNum = args && typeof args === 'object' && 'pull_number' in args ? args.pull_number : 'unknown';
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to fetch PR #${pullNum} from ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+
+    if (name === "github_create_issue") {
+        try {
+            const { owner, repo, title, body, labels, assignees } = CreateIssueSchema.parse(args);
+
+            const issue = await octokit.rest.issues.create({
+                owner,
+                repo,
+                title,
+                body,
+                labels,
+                assignees,
+            });
+
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(
+                            {
+                                success: true,
+                                issue: {
+                                    number: issue.data.number,
+                                    title: issue.data.title,
+                                    state: issue.data.state,
+                                    html_url: issue.data.html_url,
+                                    created_at: issue.data.created_at,
+                                },
+                                message: `Issue #${issue.data.number} created successfully`,
+                            },
+                            null,
+                            2
+                        ),
+                    },
+                ],
+            };
+        } catch (error: any) {
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            const title = args && typeof args === 'object' && 'title' in args ? args.title : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to create issue "${title}" in ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+
+    if (name === "github_update_issue") {
+        try {
+            const { owner, repo, issue_number, title, body, state, labels, assignees } = UpdateIssueSchema.parse(args);
+
+            const issue = await octokit.rest.issues.update({
+                owner,
+                repo,
+                issue_number,
+                title,
+                body,
+                state,
+                labels,
+                assignees,
+            });
+
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(
+                            {
+                                success: true,
+                                issue: {
+                                    number: issue.data.number,
+                                    title: issue.data.title,
+                                    state: issue.data.state,
+                                    html_url: issue.data.html_url,
+                                    updated_at: issue.data.updated_at,
+                                },
+                                message: `Issue #${issue.data.number} updated successfully`,
+                            },
+                            null,
+                            2
+                        ),
+                    },
+                ],
+            };
+        } catch (error: any) {
+            const issueNum = args && typeof args === 'object' && 'issue_number' in args ? args.issue_number : 'unknown';
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to update issue #${issueNum} in ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+
+    if (name === "github_create_pr") {
+        try {
+            const { owner, repo, title, body, head, base, draft, maintainer_can_modify } = CreatePRSchema.parse(args);
+
+            const pr = await octokit.rest.pulls.create({
+                owner,
+                repo,
+                title,
+                body,
+                head,
+                base,
+                draft,
+                maintainer_can_modify,
+            });
+
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(
+                            {
+                                success: true,
+                                pull_request: {
+                                    number: pr.data.number,
+                                    title: pr.data.title,
+                                    state: pr.data.state,
+                                    html_url: pr.data.html_url,
+                                    draft: pr.data.draft,
+                                    head: pr.data.head.ref,
+                                    base: pr.data.base.ref,
+                                    created_at: pr.data.created_at,
+                                },
+                                message: `PR #${pr.data.number} created successfully`,
+                            },
+                            null,
+                            2
+                        ),
+                    },
+                ],
+            };
+        } catch (error: any) {
+            const owner = args && typeof args === 'object' && 'owner' in args ? args.owner : 'unknown';
+            const repo = args && typeof args === 'object' && 'repo' in args ? args.repo : 'unknown';
+            const title = args && typeof args === 'object' && 'title' in args ? args.title : 'unknown';
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: error.message,
+                            status: error.status,
+                            detail: `Failed to create PR "${title}" in ${owner}/${repo}`,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+
+    throw new Error(`Unknown tool: ${name}`);
+});
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("issue-scribe-mcp server running on stdio");
+}
+
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "src",
+    "outDir": "dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": [
+    "src"
+  ]
+}