@nseed/capman-feed-mcp 1.0.0

package/README.md

@@ -0,0 +1,135 @@
+# Capman Feed MCP Server
+
+Claude Code에서 Capman Feed API를 통해 피드백을 조회/관리할 수 있게 해주는 MCP 서버입니다.
+
+## 설치
+
+```bash
+cd capman-feed-mcp
+npm install
+```
+
+## 설정
+
+### Claude Code 설정
+
+`~/.claude/claude_desktop_config.json` 또는 프로젝트의 `.claude/settings.json`에 추가:
+
+```json
+{
+  "mcpServers": {
+    "capman-feed": {
+      "command": "node",
+      "args": ["/path/to/capman-feed-mcp/index.js"],
+      "env": {
+        "CAPMAN_API_KEY": "cf_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### 환경 변수
+
+| 변수 | 필수 | 설명 |
+|------|------|------|
+| `CAPMAN_API_KEY` | ✅ | Capman Feed API 키 |
+| `CAPMAN_BASE_URL` | ❌ | API 기본 URL (기본: https://capman.kr/api/v1/feedback) |
+
+## 사용 가능한 도구
+
+### get_feedbacks
+
+피드백 목록을 조회합니다.
+
+```
+파라미터:
+- status: open, in_progress, resolved, closed
+- type: bug, feature, improvement, question
+- priority: low, medium, high, critical
+- search: 검색어
+- limit: 조회 개수 (기본 10)
+```
+
+### get_feedback_detail
+
+피드백 상세 정보를 조회합니다. 콘솔 로그, 네트워크 에러, 환경 정보 포함.
+
+```
+파라미터:
+- id: 피드백 ID (필수)
+```
+
+### update_feedback_status
+
+피드백 상태를 변경합니다.
+
+```
+파라미터:
+- id: 피드백 ID (필수)
+- status: 변경할 상태 (필수)
+```
+
+### add_comment
+
+피드백에 댓글을 추가합니다.
+
+```
+파라미터:
+- id: 피드백 ID (필수)
+- content: 댓글 내용 (필수)
+```
+
+### get_stats
+
+피드백 통계를 조회합니다.
+
+### analyze_feedback
+
+피드백의 콘솔 로그와 네트워크 에러를 분석하여 문제 원인을 파악합니다.
+
+```
+파라미터:
+- id: 분석할 피드백 ID (필수)
+```
+
+## 사용 예시
+
+Claude Code에서:
+
+```
+사용자: 새로운 버그 피드백 확인해줘
+
+Claude: [get_feedbacks 호출 - status: open, type: bug]
+        3개의 미해결 버그가 있습니다:
+        1. [bug] 결제 버튼 클릭 안됨 (high)
+        2. [bug] 로그인 후 리다이렉트 오류 (medium)
+        ...
+
+사용자: 첫 번째 버그 분석해줘
+
+Claude: [analyze_feedback 호출]
+        ## 에러 분석
+        TypeError: Cannot read property 'type' of undefined
+        → 파일: src/pages/checkout.js:142
+
+        ## 권장 조치
+        paymentMethod가 undefined인 경우 처리 필요
+
+사용자: 코드 수정하고 resolved로 변경해줘
+
+Claude: [코드 수정 후]
+        [update_feedback_status 호출 - status: resolved]
+        [add_comment 호출 - "paymentMethod null 체크 추가 (checkout.js:142)"]
+```
+
+## 개발
+
+```bash
+# 로컬 테스트
+CAPMAN_API_KEY=your_key node index.js
+```
+
+## 라이센스
+
+MIT

package/api.js

@@ -0,0 +1,89 @@
+/**
+ * Capman Feed API Client
+ */
+
+const DEFAULT_BASE_URL = 'https://capman.kr/api/v1/feedback';
+
+export class CapmanFeedAPI {
+  constructor(apiKey, baseUrl = DEFAULT_BASE_URL) {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+  }
+
+  async request(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        'X-API-Key': this.apiKey,
+        'Content-Type': 'application/json',
+        ...options.headers,
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`API Error ${response.status}: ${error}`);
+    }
+
+    return response.json();
+  }
+
+  /**
+   * 피드백 목록 조회
+   */
+  async getFeedbacks(params = {}) {
+    const query = new URLSearchParams();
+
+    if (params.status) query.set('status', params.status);
+    if (params.type) query.set('type', params.type);
+    if (params.priority) query.set('priority', params.priority);
+    if (params.search) query.set('search', params.search);
+    if (params.page) query.set('page', params.page);
+    if (params.limit) query.set('limit', params.limit || 10);
+
+    const queryString = query.toString();
+    return this.request(`/feedbacks${queryString ? `?${queryString}` : ''}`);
+  }
+
+  /**
+   * 피드백 상세 조회
+   */
+  async getFeedback(id) {
+    return this.request(`/feedbacks/${id}`);
+  }
+
+  /**
+   * 피드백 수정 (상태, 우선순위 등)
+   */
+  async updateFeedback(id, data) {
+    return this.request(`/feedbacks/${id}`, {
+      method: 'PUT',
+      body: JSON.stringify(data),
+    });
+  }
+
+  /**
+   * 댓글 목록 조회
+   */
+  async getComments(feedbackId) {
+    return this.request(`/feedbacks/${feedbackId}/comments`);
+  }
+
+  /**
+   * 댓글 추가
+   */
+  async addComment(feedbackId, content) {
+    return this.request(`/feedbacks/${feedbackId}/comments`, {
+      method: 'POST',
+      body: JSON.stringify({ content }),
+    });
+  }
+
+  /**
+   * 통계 조회
+   */
+  async getStats() {
+    return this.request('/stats');
+  }
+}

package/index.js

@@ -0,0 +1,378 @@
+#!/usr/bin/env node
+
+/**
+ * Capman Feed MCP Server
+ *
+ * Claude Code에서 Capman Feed API를 통해 피드백을 조회/관리할 수 있게 해주는 MCP 서버
+ */
+
+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 { CapmanFeedAPI } from './api.js';
+
+// 환경 변수에서 API 키 읽기
+const API_KEY = process.env.CAPMAN_API_KEY;
+const BASE_URL = process.env.CAPMAN_BASE_URL || 'https://capman.kr/api/v1/feedback';
+
+if (!API_KEY) {
+  console.error('Error: CAPMAN_API_KEY environment variable is required');
+  process.exit(1);
+}
+
+const api = new CapmanFeedAPI(API_KEY, BASE_URL);
+
+// MCP 서버 생성
+const server = new Server(
+  {
+    name: 'capman-feed',
+    version: '1.0.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// 도구 목록 정의
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: 'get_feedbacks',
+        description: '피드백 목록을 조회합니다. 상태, 유형, 우선순위로 필터링 가능합니다.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            status: {
+              type: 'string',
+              description: '상태 필터 (open, in_progress, resolved, closed)',
+              enum: ['open', 'in_progress', 'resolved', 'closed'],
+            },
+            type: {
+              type: 'string',
+              description: '유형 필터 (bug, feature, improvement, question)',
+              enum: ['bug', 'feature', 'improvement', 'question'],
+            },
+            priority: {
+              type: 'string',
+              description: '우선순위 필터 (low, medium, high, critical)',
+              enum: ['low', 'medium', 'high', 'critical'],
+            },
+            search: {
+              type: 'string',
+              description: '제목/설명 검색어',
+            },
+            limit: {
+              type: 'number',
+              description: '조회 개수 (기본: 10, 최대: 50)',
+              default: 10,
+            },
+          },
+        },
+      },
+      {
+        name: 'get_feedback_detail',
+        description: '피드백 상세 정보를 조회합니다. 콘솔 로그, 네트워크 에러, 환경 정보 등 포함.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            id: {
+              type: 'string',
+              description: '피드백 ID',
+            },
+          },
+          required: ['id'],
+        },
+      },
+      {
+        name: 'update_feedback_status',
+        description: '피드백 상태를 변경합니다.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            id: {
+              type: 'string',
+              description: '피드백 ID',
+            },
+            status: {
+              type: 'string',
+              description: '변경할 상태',
+              enum: ['open', 'in_progress', 'resolved', 'closed'],
+            },
+          },
+          required: ['id', 'status'],
+        },
+      },
+      {
+        name: 'add_comment',
+        description: '피드백에 댓글을 추가합니다. 분석 결과나 수정 내용을 기록할 때 사용.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            id: {
+              type: 'string',
+              description: '피드백 ID',
+            },
+            content: {
+              type: 'string',
+              description: '댓글 내용',
+            },
+          },
+          required: ['id', 'content'],
+        },
+      },
+      {
+        name: 'get_stats',
+        description: '피드백 통계를 조회합니다. 상태별, 유형별 개수 등.',
+        inputSchema: {
+          type: 'object',
+          properties: {},
+        },
+      },
+      {
+        name: 'analyze_feedback',
+        description: '피드백의 콘솔 로그와 네트워크 에러를 분석하여 문제 원인을 파악합니다.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            id: {
+              type: 'string',
+              description: '분석할 피드백 ID',
+            },
+          },
+          required: ['id'],
+        },
+      },
+    ],
+  };
+});
+
+// 도구 실행 핸들러
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case 'get_feedbacks': {
+        const result = await api.getFeedbacks({
+          status: args?.status,
+          type: args?.type,
+          priority: args?.priority,
+          search: args?.search,
+          limit: args?.limit || 10,
+        });
+
+        // 요약 정보 추가
+        const feedbacks = result.data || [];
+        const summary = feedbacks.map((f, i) =>
+          `${i + 1}. [${f.type}] ${f.title} (${f.status}, ${f.priority})`
+        ).join('\n');
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `총 ${result.meta?.total || feedbacks.length}개 중 ${feedbacks.length}개 조회\n\n${summary}\n\n상세 정보가 필요하면 get_feedback_detail을 사용하세요.`,
+            },
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'get_feedback_detail': {
+        const result = await api.getFeedback(args.id);
+        const feedback = result.data;
+
+        // 핵심 정보 요약
+        let summary = `## ${feedback.title}\n\n`;
+        summary += `- **유형**: ${feedback.type}\n`;
+        summary += `- **상태**: ${feedback.status}\n`;
+        summary += `- **우선순위**: ${feedback.priority}\n`;
+        summary += `- **URL**: ${feedback.url}\n`;
+        summary += `- **보고자**: ${feedback.reporterName || '익명'}\n\n`;
+
+        if (feedback.description) {
+          summary += `### 설명\n${feedback.description}\n\n`;
+        }
+
+        // 콘솔 로그 (에러/경고만)
+        const errors = (feedback.consoleLogs || []).filter(
+          (log) => log.level === 'error' || log.level === 'warn'
+        );
+        if (errors.length > 0) {
+          summary += `### 콘솔 에러/경고 (${errors.length}개)\n`;
+          errors.slice(0, 10).forEach((log) => {
+            summary += `- [${log.level}] ${log.message}\n`;
+          });
+          summary += '\n';
+        }
+
+        // 네트워크 에러
+        if (feedback.networkErrors?.length > 0) {
+          summary += `### 네트워크 에러 (${feedback.networkErrors.length}개)\n`;
+          feedback.networkErrors.slice(0, 5).forEach((err) => {
+            summary += `- ${err.method} ${err.url} → ${err.status}\n`;
+          });
+          summary += '\n';
+        }
+
+        // 환경 정보
+        if (feedback.metadata) {
+          summary += `### 환경\n`;
+          summary += `- 브라우저: ${feedback.metadata.browser}\n`;
+          summary += `- OS: ${feedback.metadata.os}\n`;
+          summary += `- 화면: ${feedback.metadata.viewportSize}\n`;
+          if (feedback.metadata.userId) {
+            summary += `- 사용자: ${feedback.metadata.userName || feedback.metadata.userId}\n`;
+          }
+        }
+
+        return {
+          content: [
+            { type: 'text', text: summary },
+            { type: 'text', text: JSON.stringify(result, null, 2) },
+          ],
+        };
+      }
+
+      case 'update_feedback_status': {
+        const result = await api.updateFeedback(args.id, { status: args.status });
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `피드백 상태가 '${args.status}'로 변경되었습니다.`,
+            },
+          ],
+        };
+      }
+
+      case 'add_comment': {
+        const result = await api.addComment(args.id, args.content);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: `댓글이 추가되었습니다: "${args.content.slice(0, 50)}..."`,
+            },
+          ],
+        };
+      }
+
+      case 'get_stats': {
+        const result = await api.getStats();
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      case 'analyze_feedback': {
+        const result = await api.getFeedback(args.id);
+        const feedback = result.data;
+
+        let analysis = `# 피드백 분석: ${feedback.title}\n\n`;
+
+        // 콘솔 로그 분석
+        const errors = (feedback.consoleLogs || []).filter(
+          (log) => log.level === 'error'
+        );
+        const warnings = (feedback.consoleLogs || []).filter(
+          (log) => log.level === 'warn'
+        );
+
+        analysis += `## 에러 분석\n\n`;
+
+        if (errors.length === 0 && warnings.length === 0) {
+          analysis += `콘솔에 에러/경고가 없습니다.\n\n`;
+        } else {
+          if (errors.length > 0) {
+            analysis += `### 에러 (${errors.length}개)\n`;
+            errors.forEach((err) => {
+              analysis += `\`\`\`\n${err.message}\n\`\`\`\n`;
+
+              // 파일/라인 추출 시도
+              const fileMatch = err.message.match(/at\s+.*?([\/\w-]+\.(js|ts|jsx|tsx)):(\d+)/);
+              if (fileMatch) {
+                analysis += `→ 파일: ${fileMatch[1]}:${fileMatch[3]}\n\n`;
+              }
+            });
+          }
+
+          if (warnings.length > 0) {
+            analysis += `### 경고 (${warnings.length}개)\n`;
+            warnings.slice(0, 5).forEach((warn) => {
+              analysis += `- ${warn.message.slice(0, 200)}\n`;
+            });
+          }
+        }
+
+        // 네트워크 에러 분석
+        if (feedback.networkErrors?.length > 0) {
+          analysis += `\n## 네트워크 에러\n\n`;
+          feedback.networkErrors.forEach((err) => {
+            analysis += `- \`${err.method} ${err.url}\` → ${err.status} ${err.statusText}\n`;
+          });
+        }
+
+        // URL 분석
+        if (feedback.url) {
+          const urlObj = new URL(feedback.url);
+          analysis += `\n## 페이지 정보\n\n`;
+          analysis += `- 경로: ${urlObj.pathname}\n`;
+          analysis += `- 쿼리: ${urlObj.search || '없음'}\n`;
+          analysis += `\n→ 관련 라우트 파일을 찾아보세요.\n`;
+        }
+
+        analysis += `\n## 권장 조치\n\n`;
+        analysis += `1. 위 에러 메시지에서 파일/라인 정보 확인\n`;
+        analysis += `2. 해당 코드 검색 및 수정\n`;
+        analysis += `3. 수정 완료 후 상태를 'resolved'로 변경\n`;
+
+        return {
+          content: [{ type: 'text', text: analysis }],
+        };
+      }
+
+      default:
+        return {
+          content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+          isError: true,
+        };
+    }
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `Error: ${error.message}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+// 서버 시작
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('Capman Feed MCP Server running');
+}
+
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@nseed/capman-feed-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Capman Feed API - enables Claude Code and GitHub Copilot to access feedback data",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "capman-feed-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "copilot",
+    "capman",
+    "feedback",
+    "bug-tracking"
+  ],
+  "author": "nseed <shin@nseed.co.kr>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nseed/capman-feed-mcp"
+  },
+  "homepage": "https://capman.kr/developers",
+  "bugs": {
+    "url": "https://github.com/nseed/capman-feed-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}