gitlab-mcp 0.1.3 → 0.1.5

package/build/index.js

@@ -19,11 +19,12 @@ import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLab
 GitLabDiscussionNoteSchema, // Added
 GitLabDiscussionSchema, UpdateMergeRequestNoteSchema, // Added
 ListMergeRequestDiscussionsSchema, } from "./schemas.js";
-// Load .env from the current working directory
-config({ path: path.resolve(process.cwd(), ".env") });
 const argv = yargs(hideBin(process.argv)).argv;
 const isSSE = argv.mode === "sse";
 const port = argv.port ?? 3044;
+const envFile = argv.envFile ?? ".env";
+// Load .env from the current working directory
+config({ path: envFile ?? path.resolve(process.cwd(), ".env") });
 /**
  * Read version from package.json
  */
@@ -271,7 +272,6 @@ if (!GITLAB_PERSONAL_ACCESS_TOKEN) {
 }
 /**
  * Common headers for GitLab API requests
- * GitLab API 공통 헤더 (Common headers for GitLab API)
  */
 const DEFAULT_HEADERS = {
     Accept: "application/json",
@@ -280,7 +280,6 @@ const DEFAULT_HEADERS = {
 };
 /**
  * Utility function for handling GitLab API errors
- * API 에러 처리를 위한 유틸리티 함수 (Utility function for handling API errors)
  *
  * @param {import("node-fetch").Response} response - The response from GitLab API
  * @throws {Error} Throws an error with response details if the request failed
@@ -303,14 +302,12 @@ async function handleGitLabError(response) {
 }
 /**
  * Create a fork of a GitLab project
- * 프로젝트 포크 생성 (Create a project fork)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {string} [namespace] - The namespace to fork the project to
  * @returns {Promise<GitLabFork>} The created fork
  */
 async function forkProject(projectId, namespace) {
-    // API 엔드포인트 URL 생성
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/fork`);
     if (namespace) {
         url.searchParams.append("namespace", namespace);
@@ -319,7 +316,6 @@ async function forkProject(projectId, namespace) {
         method: "POST",
         headers: DEFAULT_HEADERS,
     });
-    // 이미 존재하는 프로젝트인 경우 처리
     if (response.status === 409) {
         throw new Error("Project already exists in the target namespace");
     }
@@ -329,7 +325,6 @@ async function forkProject(projectId, namespace) {
 }
 /**
  * Create a new branch in a GitLab project
- * 새로운 브랜치 생성 (Create a new branch)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {z.infer<typeof CreateBranchOptionsSchema>} options - Branch creation options
@@ -350,7 +345,6 @@ async function createBranch(projectId, options) {
 }
 /**
  * Get the default branch for a GitLab project
- * 프로젝트의 기본 브랜치 조회 (Get the default branch of a project)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @returns {Promise<string>} The name of the default branch
@@ -366,7 +360,6 @@ async function getDefaultBranchRef(projectId) {
 }
 /**
  * Get the contents of a file from a GitLab project
- * 파일 내용 조회 (Get file contents)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {string} filePath - The path of the file to get
@@ -375,7 +368,6 @@ async function getDefaultBranchRef(projectId) {
  */
 async function getFileContents(projectId, filePath, ref) {
     const encodedPath = encodeURIComponent(filePath);
-    // ref가 없는 경우 default branch를 가져옴
     if (!ref) {
         ref = await getDefaultBranchRef(projectId);
     }
@@ -384,14 +376,12 @@ async function getFileContents(projectId, filePath, ref) {
     const response = await fetch(url.toString(), {
         headers: DEFAULT_HEADERS,
     });
-    // 파일을 찾을 수 없는 경우 처리
     if (response.status === 404) {
         throw new Error(`File not found: ${filePath}`);
     }
     await handleGitLabError(response);
     const data = await response.json();
     const parsedData = GitLabContentSchema.parse(data);
-    // Base64로 인코딩된 파일 내용을 UTF-8로 디코딩
     if (!Array.isArray(parsedData) && parsedData.content) {
         parsedData.content = Buffer.from(parsedData.content, "base64").toString("utf8");
         parsedData.encoding = "utf8";
@@ -400,7 +390,6 @@ async function getFileContents(projectId, filePath, ref) {
 }
 /**
  * Create a new issue in a GitLab project
- * 이슈 생성 (Create an issue)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {z.infer<typeof CreateIssueOptionsSchema>} options - Issue creation options
@@ -419,7 +408,6 @@ async function createIssue(projectId, options) {
             labels: options.labels?.join(","),
         }),
     });
-    // 잘못된 요청 처리
     if (response.status === 400) {
         const errorBody = await response.text();
         throw new Error(`Invalid request: ${errorBody}`);
@@ -430,7 +418,6 @@ async function createIssue(projectId, options) {
 }
 /**
  * List issues in a GitLab project
- * 프로젝트의 이슈 목록 조회
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {Object} options - Options for listing issues
@@ -459,7 +446,6 @@ async function listIssues(projectId, options = {}) {
 }
 /**
  * Get a single issue from a GitLab project
- * 단일 이슈 조회
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} issueIid - The internal ID of the project issue
@@ -476,7 +462,6 @@ async function getIssue(projectId, issueIid) {
 }
 /**
  * Update an issue in a GitLab project
- * 이슈 업데이트
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} issueIid - The internal ID of the project issue
@@ -501,7 +486,6 @@ async function updateIssue(projectId, issueIid, options) {
 }
 /**
  * Delete an issue from a GitLab project
- * 이슈 삭제
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} issueIid - The internal ID of the project issue
@@ -517,7 +501,6 @@ async function deleteIssue(projectId, issueIid) {
 }
 /**
  * List all issue links for a specific issue
- * 이슈 관계 목록 조회
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} issueIid - The internal ID of the project issue
@@ -534,7 +517,6 @@ async function listIssueLinks(projectId, issueIid) {
 }
 /**
  * Get a specific issue link
- * 특정 이슈 관계 조회
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} issueIid - The internal ID of the project issue
@@ -552,7 +534,6 @@ async function getIssueLink(projectId, issueIid, issueLinkId) {
 }
 /**
  * Create an issue link between two issues
- * 이슈 관계 생성
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} issueIid - The internal ID of the project issue
@@ -578,7 +559,6 @@ async function createIssueLink(projectId, issueIid, targetProjectId, targetIssue
 }
 /**
  * Delete an issue link
- * 이슈 관계 삭제
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} issueIid - The internal ID of the project issue
@@ -595,7 +575,6 @@ async function deleteIssueLink(projectId, issueIid, issueLinkId) {
 }
 /**
  * Create a new merge request in a GitLab project
- * 병합 요청 생성
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {z.infer<typeof CreateMergeRequestOptionsSchema>} options - Merge request creation options
@@ -632,7 +611,6 @@ async function createMergeRequest(projectId, options) {
 }
 /**
  * List merge request discussion items
- * 병합 요청 토론 목록 조회
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} mergeRequestIid - The IID of a merge request
@@ -650,7 +628,6 @@ async function listMergeRequestDiscussions(projectId, mergeRequestIid) {
 }
 /**
  * Modify an existing merge request thread note
- * 병합 요청 토론 노트 수정
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} mergeRequestIid - The IID of a merge request
@@ -677,7 +654,6 @@ async function updateMergeRequestNote(projectId, mergeRequestIid, discussionId,
 }
 /**
  * Create or update a file in a GitLab project
- * 파일 생성 또는 업데이트
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {string} filePath - The path of the file to create or update
@@ -751,7 +727,6 @@ async function createOrUpdateFile(projectId, filePath, content, commitMessage, b
 }
 /**
  * Create a tree structure in a GitLab project repository
- * 저장소에 트리 구조 생성
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {FileOperation[]} files - Array of file operations
@@ -791,7 +766,6 @@ async function createTree(projectId, files, ref) {
 }
 /**
  * Create a commit in a GitLab project repository
- * 저장소에 커밋 생성
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {string} message - The commit message
@@ -902,7 +876,6 @@ async function createRepository(options) {
 }
 /**
  * Get merge request details
- * MR 조회 함수 (Function to retrieve merge request)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} mergeRequestIid - The internal ID of the merge request
@@ -939,7 +912,6 @@ async function getMergeRequestDiffs(projectId, mergeRequestIid, view) {
 }
 /**
  * Update a merge request
- * MR 업데이트 함수 (Function to update merge request)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {number} mergeRequestIid - The internal ID of the merge request
@@ -958,7 +930,6 @@ async function updateMergeRequest(projectId, mergeRequestIid, options) {
 }
 /**
  * Create a new note (comment) on an issue or merge request
- * 📦 새로운 함수: createNote - 이슈 또는 병합 요청에 노트(댓글)를 추가하는 함수
  * (New function: createNote - Function to add a note (comment) to an issue or merge request)
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
@@ -967,9 +938,7 @@ async function updateMergeRequest(projectId, mergeRequestIid, options) {
  * @param {string} body - The content of the note
  * @returns {Promise<any>} The created note
  */
-async function createNote(projectId, noteableType, // 'issue' 또는 'merge_request' 타입 명시
-noteableIid, body) {
-    // ⚙️ 응답 타입은 GitLab API 문서에 따라 조정 가능
+async function createNote(projectId, noteableType, noteableIid, body) {
     const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/${noteableType}s/${noteableIid}/notes` // Using plural form (issues/merge_requests) as per GitLab API documentation
     );
     const response = await fetch(url.toString(), {
@@ -985,7 +954,6 @@ noteableIid, body) {
 }
 /**
  * List all namespaces
- * 사용 가능한 모든 네임스페이스 목록 조회
  *
  * @param {Object} options - Options for listing namespaces
  * @param {string} [options.search] - Search query to filter namespaces
@@ -1013,7 +981,6 @@ async function listNamespaces(options) {
 }
 /**
  * Get details on a namespace
- * 네임스페이스 상세 정보 조회
  *
  * @param {string} id - The ID or URL-encoded path of the namespace
  * @returns {Promise<GitLabNamespace>} The namespace details
@@ -1029,7 +996,6 @@ async function getNamespace(id) {
 }
 /**
  * Verify if a namespace exists
- * 네임스페이스 존재 여부 확인
  *
  * @param {string} namespacePath - The path of the namespace to check
  * @param {number} [parentId] - The ID of the parent namespace
@@ -1049,7 +1015,6 @@ async function verifyNamespaceExistence(namespacePath, parentId) {
 }
 /**
  * Get a single project
- * 단일 프로젝트 조회
  *
  * @param {string} projectId - The ID or URL-encoded path of the project
  * @param {Object} options - Options for getting project details
@@ -1078,7 +1043,6 @@ async function getProject(projectId, options = {}) {
 }
 /**
  * List projects
- * 프로젝트 목록 조회
  *
  * @param {Object} options - Options for listing projects
  * @returns {Promise<GitLabProject[]>} List of projects
@@ -1637,7 +1601,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 /**
  * Initialize and run the server
- * 서버 초기화 및 실행
  */
 async function runServer() {
     if (isSSE) {
@@ -1647,10 +1610,6 @@ async function runServer() {
             console.log("Establishing new SSE connection");
             transport = new SSEServerTransport("/messages", res);
             await server.connect(transport);
-            server.onclose = async () => {
-                await server.close();
-                process.exit(0);
-            };
         });
         app.post("/messages", async (req, res) => {
             await transport?.handlePostMessage(req, res);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab-mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Model Context Protocol server for GitLab integration",
   "main": "./build/index.js",
   "type": "module",