@zereight/mcp-gitlab 1.0.16 → 1.0.18

package/README.md

@@ -40,139 +40,36 @@ env GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token GITLAB_API_URL=your_gitlab_ap
 - `GITLAB_PERSONAL_ACCESS_TOKEN`: Your GitLab personal access token.
 - `GITLAB_API_URL`: Your GitLab API URL. (Default: `https://gitlab.com/api/v4`)
 
-## Tools 🛠️
-
-1. `create_or_update_file`
-
-   - Create or update a single file in a GitLab project. 📝
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `file_path` (string): Path to create/update the file
-     - `content` (string): File content
-     - `commit_message` (string): Commit message
-     - `branch` (string): Branch to create/update the file in
-     - `previous_path` (optional string): Previous file path when renaming a file
-   - Returns: File content and commit details
-
-2. `push_files`
-
-   - Push multiple files in a single commit. 📤
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `branch` (string): Branch to push to
-     - `files` (array): Array of files to push, each with `file_path` and `content` properties
-     - `commit_message` (string): Commit message
-   - Returns: Updated branch reference
-
-3. `search_repositories`
-
-   - Search for GitLab projects. 🔍
-   - Inputs:
-     - `search` (string): Search query
-     - `page` (optional number): Page number (default: 1)
-     - `per_page` (optional number): Results per page (default: 20, max: 100)
-   - Returns: Project search results
-
-4. `create_repository`
-
-   - Create a new GitLab project. ➕
-   - Inputs:
-     - `name` (string): Project name
-     - `description` (optional string): Project description
-     - `visibility` (optional string): Project visibility level (public, private, internal)
-     - `initialize_with_readme` (optional boolean): Initialize with README
-   - Returns: Details of the created project
-
-5. `get_file_contents`
-
-   - Get the contents of a file or directory. 📂
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `file_path` (string): Path to the file/directory
-     - `ref` (optional string): Branch, tag, or commit SHA (default: default branch)
-   - Returns: File/directory content
-
-6. `create_issue`
-
-   - Create a new issue. 🐛
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `title` (string): Issue title
-     - `description` (string): Issue description
-     - `assignee_ids` (optional number[]): Array of assignee IDs
-     - `milestone_id` (optional number): Milestone ID
-     - `labels` (optional string[]): Array of labels
-   - Returns: Details of the created issue
-
-7. `create_merge_request`
-
-   - Create a new merge request. 🚀
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `title` (string): Merge request title
-     - `description` (string): Merge request description
-     - `source_branch` (string): Branch with changes
-     - `target_branch` (string): Branch to merge into
-     - `allow_collaboration` (optional boolean): Allow collaborators to push commits to the source branch
-     - `draft` (optional boolean): Create as a draft merge request
-   - Returns: Details of the created merge request
-
-8. `fork_repository`
-
-   - Fork a project. 🍴
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path to fork
-     - `namespace` (optional string): Namespace to fork into (default: user namespace)
-   - Returns: Details of the forked project
-
-9. `create_branch`
-
-   - Create a new branch. 🌿
-   - Inputs:
-     - `project_id` (string): Project ID or namespace/project_path
-     - `name` (string): New branch name
-     - `ref` (optional string): Ref to create the branch from (branch, tag, commit SHA, default: default branch)
-   - Returns: Created branch reference
-
-10. `get_merge_request`
-
-    - Get details of a merge request. ℹ️
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `merge_request_iid` (number): Merge request IID
-    - Returns: Merge request details
-
-11. `get_merge_request_diffs`
-
-    - Get changes (diffs) of a merge request. diff
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `merge_request_iid` (number): Merge request IID
-      - `view` (optional string): Diff view type ('inline' or 'parallel')
-    - Returns: Array of merge request diff information
-
-12. `update_merge_request`
-
-    - Update a merge request. 🔄
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `merge_request_iid` (number): Merge request IID
-      - `title` (optional string): New title
-      - `description` (string): New description
-      - `target_branch` (optional string): New target branch
-      - `state_event` (optional string): Merge request state change event ('close', 'reopen')
-      - `remove_source_branch` (optional boolean): Remove source branch after merge
-      - `allow_collaboration` (optional boolean): Allow collaborators to push commits to the source branch
-    - Returns: Updated merge request details
-
-13. `create_note`
-    - Create a new note (comment) to an issue or merge request. 💬
-    - Inputs:
-      - `project_id` (string): Project ID or namespace/project_path
-      - `noteable_type` (string): Type of noteable ("issue" or "merge_request")
-      - `noteable_iid` (number): IID of the issue or merge request
-      - `body` (string): Note content
-    - Returns: Details of the created note
+## Tools Reference 🛠️
+
+| Tool | Description | Parameters | Returns |
+|------|-------------|------------|---------|
+| **`create_or_update_file`** | Create or update a single file in a GitLab project 📝 | • `project_id` (string): Project ID or path<br>• `file_path` (string): Path to create/update<br>• `content` (string): File content<br>• `commit_message` (string): Commit message<br>• `branch` (string): Target branch<br>• `previous_path` (optional): Previous path when renaming | File content and commit details |
+| **`push_files`** | Push multiple files in a single commit 📤 (internally creates a tree and commit) | • `project_id` (string): Project ID or path<br>• `branch` (string): Target branch<br>• `files` (array): Array of files with `file_path` and `content`<br>• `commit_message` (string): Commit message | Updated branch reference |
+| **`search_repositories`** | Search for GitLab projects 🔍 | • `search` (string): Search query<br>• `page` (optional): Page number (default: 1)<br>• `per_page` (optional): Results per page (default: 20) | Project search results |
+| **`create_repository`** | Create a new GitLab project ➕ | • `name` (string): Project name<br>• `description` (optional): Project description<br>• `visibility` (optional): Visibility level<br>• `initialize_with_readme` (optional): Initialize with README | Created project details |
+| **`get_file_contents`** | Get the contents of a file or directory 📂 | • `project_id` (string): Project ID or path<br>• `file_path` (string): Path to file/directory<br>• `ref` (optional): Branch, tag, or commit SHA | File/directory content |
+| **`create_issue`** | Create a new issue 🐛 | • `project_id` (string): Project ID or path<br>• `title` (string): Issue title<br>• `description` (string): Issue description<br>• `assignee_ids` (optional): Array of assignee IDs<br>• `milestone_id` (optional): Milestone ID<br>• `labels` (optional): Array of labels | Created issue details |
+| **`list_issues`** | List issues in a project with comprehensive filtering options 📋 | • `project_id` (string): Project ID or path<br>• Optional filters: `assignee_id`, `assignee_username`, `author_id`, `author_username`, `confidential`, `created_after/before`, `due_date`, `label_name`, `milestone`, `scope`, `search`, `state`, `updated_after/before`<br>• Pagination: `page`, `per_page` | Array of issues |
+| **`get_issue`** | Get details of a specific issue | • `project_id` (string): Project ID or path<br>• `issue_iid` (number): Issue IID | Issue details |
+| **`update_issue`** | Update an existing issue ✏️ | • `project_id` (string): Project ID or path<br>• `issue_iid` (number): Issue IID<br>• Editable fields: `title`, `description`, `assignee_ids`, `labels`, `milestone_id`, `state_event` (close/reopen), `confidential`, `discussion_locked`, `due_date`, `weight` | Updated issue details |
+| **`delete_issue`** | Delete an issue | • `project_id` (string): Project ID or path<br>• `issue_iid` (number): Issue IID | Success message |
+| **`list_issue_links`** | List all links for a specific issue | • `project_id` (string): Project ID or path<br>• `issue_iid` (number): Issue IID | Array of linked issues |
+| **`get_issue_link`** | Get details of a specific issue link | • `project_id` (string): Project ID or path<br>• `issue_iid` (number): Issue IID<br>• `issue_link_id` (number): Link ID | Issue link details |
+| **`create_issue_link`** | Create a link between two issues | • `project_id` (string): Project ID or path<br>• `issue_iid` (number): Source issue IID<br>• `target_project_id` (string): Target project ID<br>• `target_issue_iid` (number): Target issue IID<br>• `link_type` (optional): Relationship type | Created link details |
+| **`delete_issue_link`** | Delete an issue link | • `project_id` (string): Project ID or path<br>• `issue_iid` (number): Issue IID<br>• `issue_link_id` (number): Link ID | Success message |
+| **`create_merge_request`** | Create a new merge request 🚀 | • `project_id` (string): Project ID or path<br>• `title` (string): MR title<br>• `description` (string): MR description<br>• `source_branch` (string): Branch with changes<br>• `target_branch` (string): Branch to merge into<br>• `allow_collaboration` (optional): Allow collaborators<br>• `draft` (optional): Create as draft | Created merge request details |
+| **`fork_repository`** | Fork a project 🍴 | • `project_id` (string): Project ID or path to fork<br>• `namespace` (optional): Namespace to fork into | Forked project details |
+| **`create_branch`** | Create a new branch 🌿 | • `project_id` (string): Project ID or path<br>• `branch` (string): New branch name<br>• `ref` (optional): Reference to create from | Created branch reference |
+| **`get_merge_request`** | Get details of a merge request ℹ️ | • `project_id` (string): Project ID or path<br>• `merge_request_iid` (number): MR IID | Merge request details |
+| **`get_merge_request_diffs`** | Get changes of a merge request | • `project_id` (string): Project ID or path<br>• `merge_request_iid` (number): MR IID<br>• `view` (optional): Diff view type | Array of merge request diffs |
+| **`update_merge_request`** | Update a merge request 🔄 | • `project_id` (string): Project ID or path<br>• `merge_request_iid` (number): MR IID<br>• Editable fields: `title`, `description`, `target_branch`, `assignee_ids`, `labels`, `state_event` (close/reopen), `remove_source_branch`, `squash`, `draft` | Updated merge request details |
+| **`create_note`** | Create a comment on an issue or MR 💬 | • `project_id` (string): Project ID or path<br>• `noteable_type` (string): "issue" or "merge_request"<br>• `noteable_iid` (number): IID of the issue or MR<br>• `body` (string): Comment content | Created note details |
+| **`list_namespaces`** | List available namespaces | • `search` (optional): Search term<br>• `page` (optional): Page number<br>• `per_page` (optional): Results per page<br>• `owned` (optional): Filter by ownership | Array of namespaces |
+| **`get_namespace`** | Get details of a namespace | • `namespace_id` (string): Namespace ID or path | Namespace details |
+| **`verify_namespace`** | Check if a namespace exists | • `path` (string): Namespace path to verify | Verification result |
+| **`get_project`** | Get details of a specific project | • `project_id` (string): Project ID or path | Project details |
+| **`list_projects`** | List accessible projects with rich filtering options 📊 | • Search/filtering: `search`, `owned`, `membership`, `archived`, `visibility`<br>• Features filtering: `with_issues_enabled`, `with_merge_requests_enabled`<br>• Sorting: `order_by`, `sort`<br>• Access control: `min_access_level`<br>• Pagination: `page`, `per_page`, `simple` | Array of projects |
 
 ## Environment Variable Configuration
 

package/build/index.js

@@ -9,7 +9,7 @@ import { fileURLToPath } from "url";
 import { dirname } from "path";
 import fs from "fs";
 import path from "path";
-import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabIssueSchema, GitLabMergeRequestSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabSearchResponseSchema, GitLabTreeSchema, GitLabCommitSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, CreateNoteSchema, } from "./schemas.js";
+import { GitLabForkSchema, GitLabReferenceSchema, GitLabRepositorySchema, GitLabIssueSchema, GitLabMergeRequestSchema, GitLabContentSchema, GitLabCreateUpdateFileResponseSchema, GitLabSearchResponseSchema, GitLabTreeSchema, GitLabCommitSchema, GitLabNamespaceSchema, GitLabNamespaceExistsResponseSchema, GitLabProjectSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, ListIssuesSchema, GetIssueSchema, UpdateIssueSchema, DeleteIssueSchema, GitLabIssueLinkSchema, GitLabIssueWithLinkDetailsSchema, ListIssueLinksSchema, GetIssueLinkSchema, CreateIssueLinkSchema, DeleteIssueLinkSchema, ListNamespacesSchema, GetNamespaceSchema, VerifyNamespaceSchema, GetProjectSchema, ListProjectsSchema, CreateNoteSchema, } from "./schemas.js";
 /**
  * Read version from package.json
  */
@@ -215,6 +215,171 @@ async function createIssue(projectId, options) {
     const data = await response.json();
     return GitLabIssueSchema.parse(data);
 }
+/**
+ * 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
+ * @returns {Promise<GitLabIssue[]>} List of issues
+ */
+async function listIssues(projectId, options = {}) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues`);
+    // Add all query parameters
+    Object.entries(options).forEach(([key, value]) => {
+        if (value !== undefined) {
+            if (key === 'label_name' && Array.isArray(value)) {
+                // Handle array of labels
+                url.searchParams.append(key, value.join(','));
+            }
+            else {
+                url.searchParams.append(key, value.toString());
+            }
+        }
+    });
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return z.array(GitLabIssueSchema).parse(data);
+}
+/**
+ * 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
+ * @returns {Promise<GitLabIssue>} The issue
+ */
+async function getIssue(projectId, issueIid) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabIssueSchema.parse(data);
+}
+/**
+ * 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
+ * @param {Object} options - Update options for the issue
+ * @returns {Promise<GitLabIssue>} The updated issue
+ */
+async function updateIssue(projectId, issueIid, options) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
+    // Convert labels array to comma-separated string if present
+    const body = { ...options };
+    if (body.labels && Array.isArray(body.labels)) {
+        body.labels = body.labels.join(',');
+    }
+    const response = await fetch(url.toString(), {
+        method: "PUT",
+        headers: DEFAULT_HEADERS,
+        body: JSON.stringify(body),
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabIssueSchema.parse(data);
+}
+/**
+ * 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
+ * @returns {Promise<void>}
+ */
+async function deleteIssue(projectId, issueIid) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}`);
+    const response = await fetch(url.toString(), {
+        method: "DELETE",
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+}
+/**
+ * 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
+ * @returns {Promise<GitLabIssueWithLinkDetails[]>} List of issues with link details
+ */
+async function listIssueLinks(projectId, issueIid) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links`);
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return z.array(GitLabIssueWithLinkDetailsSchema).parse(data);
+}
+/**
+ * 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
+ * @param {number} issueLinkId - The ID of the issue link
+ * @returns {Promise<GitLabIssueLink>} The issue link
+ */
+async function getIssueLink(projectId, issueIid, issueLinkId) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links/${issueLinkId}`);
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabIssueLinkSchema.parse(data);
+}
+/**
+ * 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
+ * @param {string} targetProjectId - The ID or URL-encoded path of the target project
+ * @param {number} targetIssueIid - The internal ID of the target project issue
+ * @param {string} linkType - The type of the relation (relates_to, blocks, is_blocked_by)
+ * @returns {Promise<GitLabIssueLink>} The created issue link
+ */
+async function createIssueLink(projectId, issueIid, targetProjectId, targetIssueIid, linkType = 'relates_to') {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links`);
+    const response = await fetch(url.toString(), {
+        method: "POST",
+        headers: DEFAULT_HEADERS,
+        body: JSON.stringify({
+            target_project_id: targetProjectId,
+            target_issue_iid: targetIssueIid,
+            link_type: linkType
+        }),
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabIssueLinkSchema.parse(data);
+}
+/**
+ * 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
+ * @param {number} issueLinkId - The ID of the issue link
+ * @returns {Promise<void>}
+ */
+async function deleteIssueLink(projectId, issueIid, issueLinkId) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}/issues/${issueIid}/links/${issueLinkId}`);
+    const response = await fetch(url.toString(), {
+        method: "DELETE",
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+}
 /**
  * Create a new merge request in a GitLab project
  * 병합 요청 생성
@@ -560,6 +725,121 @@ noteableIid, body) {
     }
     return await response.json();
 }
+/**
+ * List all namespaces
+ * 사용 가능한 모든 네임스페이스 목록 조회
+ *
+ * @param {Object} options - Options for listing namespaces
+ * @param {string} [options.search] - Search query to filter namespaces
+ * @param {boolean} [options.owned_only] - Only return namespaces owned by the authenticated user
+ * @param {boolean} [options.top_level_only] - Only return top-level namespaces
+ * @returns {Promise<GitLabNamespace[]>} List of namespaces
+ */
+async function listNamespaces(options) {
+    const url = new URL(`${GITLAB_API_URL}/namespaces`);
+    if (options.search) {
+        url.searchParams.append("search", options.search);
+    }
+    if (options.owned_only) {
+        url.searchParams.append("owned_only", "true");
+    }
+    if (options.top_level_only) {
+        url.searchParams.append("top_level_only", "true");
+    }
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return z.array(GitLabNamespaceSchema).parse(data);
+}
+/**
+ * Get details on a namespace
+ * 네임스페이스 상세 정보 조회
+ *
+ * @param {string} id - The ID or URL-encoded path of the namespace
+ * @returns {Promise<GitLabNamespace>} The namespace details
+ */
+async function getNamespace(id) {
+    const url = new URL(`${GITLAB_API_URL}/namespaces/${encodeURIComponent(id)}`);
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabNamespaceSchema.parse(data);
+}
+/**
+ * Verify if a namespace exists
+ * 네임스페이스 존재 여부 확인
+ *
+ * @param {string} namespacePath - The path of the namespace to check
+ * @param {number} [parentId] - The ID of the parent namespace
+ * @returns {Promise<GitLabNamespaceExistsResponse>} The verification result
+ */
+async function verifyNamespaceExistence(namespacePath, parentId) {
+    const url = new URL(`${GITLAB_API_URL}/namespaces/${encodeURIComponent(namespacePath)}/exists`);
+    if (parentId) {
+        url.searchParams.append("parent_id", parentId.toString());
+    }
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabNamespaceExistsResponseSchema.parse(data);
+}
+/**
+ * Get a single project
+ * 단일 프로젝트 조회
+ *
+ * @param {string} projectId - The ID or URL-encoded path of the project
+ * @param {Object} options - Options for getting project details
+ * @param {boolean} [options.license] - Include project license data
+ * @param {boolean} [options.statistics] - Include project statistics
+ * @param {boolean} [options.with_custom_attributes] - Include custom attributes in response
+ * @returns {Promise<GitLabProject>} Project details
+ */
+async function getProject(projectId, options = {}) {
+    const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(projectId)}`);
+    if (options.license) {
+        url.searchParams.append("license", "true");
+    }
+    if (options.statistics) {
+        url.searchParams.append("statistics", "true");
+    }
+    if (options.with_custom_attributes) {
+        url.searchParams.append("with_custom_attributes", "true");
+    }
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return GitLabRepositorySchema.parse(data);
+}
+/**
+ * List projects
+ * 프로젝트 목록 조회
+ *
+ * @param {Object} options - Options for listing projects
+ * @returns {Promise<GitLabProject[]>} List of projects
+ */
+async function listProjects(options = {}) {
+    const url = new URL(`${GITLAB_API_URL}/projects`);
+    // Add all the query parameters from options
+    Object.entries(options).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, value.toString());
+        }
+    });
+    const response = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+    });
+    await handleGitLabError(response);
+    const data = await response.json();
+    return z.array(GitLabRepositorySchema).parse(data);
+}
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
         tools: [
@@ -628,6 +908,71 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 description: "Create a new note (comment) to an issue or merge request",
                 inputSchema: zodToJsonSchema(CreateNoteSchema),
             },
+            {
+                name: "list_issues",
+                description: "List issues in a GitLab project with filtering options",
+                inputSchema: zodToJsonSchema(ListIssuesSchema),
+            },
+            {
+                name: "get_issue",
+                description: "Get details of a specific issue in a GitLab project",
+                inputSchema: zodToJsonSchema(GetIssueSchema),
+            },
+            {
+                name: "update_issue",
+                description: "Update an issue in a GitLab project",
+                inputSchema: zodToJsonSchema(UpdateIssueSchema),
+            },
+            {
+                name: "delete_issue",
+                description: "Delete an issue from a GitLab project",
+                inputSchema: zodToJsonSchema(DeleteIssueSchema),
+            },
+            {
+                name: "list_issue_links",
+                description: "List all issue links for a specific issue",
+                inputSchema: zodToJsonSchema(ListIssueLinksSchema),
+            },
+            {
+                name: "get_issue_link",
+                description: "Get a specific issue link",
+                inputSchema: zodToJsonSchema(GetIssueLinkSchema),
+            },
+            {
+                name: "create_issue_link",
+                description: "Create an issue link between two issues",
+                inputSchema: zodToJsonSchema(CreateIssueLinkSchema),
+            },
+            {
+                name: "delete_issue_link",
+                description: "Delete an issue link",
+                inputSchema: zodToJsonSchema(DeleteIssueLinkSchema),
+            },
+            {
+                name: "list_namespaces",
+                description: "List all namespaces available to the current user",
+                inputSchema: zodToJsonSchema(ListNamespacesSchema),
+            },
+            {
+                name: "get_namespace",
+                description: "Get details of a namespace by ID or path",
+                inputSchema: zodToJsonSchema(GetNamespaceSchema),
+            },
+            {
+                name: "verify_namespace",
+                description: "Verify if a namespace path exists",
+                inputSchema: zodToJsonSchema(VerifyNamespaceSchema),
+            },
+            {
+                name: "get_project",
+                description: "Get details of a specific project",
+                inputSchema: zodToJsonSchema(GetProjectSchema),
+            },
+            {
+                name: "list_projects",
+                description: "List projects accessible by the current user",
+                inputSchema: zodToJsonSchema(ListProjectsSchema),
+            },
         ],
     };
 });
@@ -751,6 +1096,89 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "list_namespaces": {
+                const args = ListNamespacesSchema.parse(request.params.arguments);
+                const url = new URL(`${GITLAB_API_URL}/namespaces`);
+                if (args.search) {
+                    url.searchParams.append("search", args.search);
+                }
+                if (args.page) {
+                    url.searchParams.append("page", args.page.toString());
+                }
+                if (args.per_page) {
+                    url.searchParams.append("per_page", args.per_page.toString());
+                }
+                if (args.owned) {
+                    url.searchParams.append("owned", args.owned.toString());
+                }
+                const response = await fetch(url.toString(), {
+                    headers: DEFAULT_HEADERS,
+                });
+                await handleGitLabError(response);
+                const data = await response.json();
+                const namespaces = z.array(GitLabNamespaceSchema).parse(data);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(namespaces, null, 2) }],
+                };
+            }
+            case "get_namespace": {
+                const args = GetNamespaceSchema.parse(request.params.arguments);
+                const url = new URL(`${GITLAB_API_URL}/namespaces/${encodeURIComponent(args.namespace_id)}`);
+                const response = await fetch(url.toString(), {
+                    headers: DEFAULT_HEADERS,
+                });
+                await handleGitLabError(response);
+                const data = await response.json();
+                const namespace = GitLabNamespaceSchema.parse(data);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(namespace, null, 2) }],
+                };
+            }
+            case "verify_namespace": {
+                const args = VerifyNamespaceSchema.parse(request.params.arguments);
+                const url = new URL(`${GITLAB_API_URL}/namespaces/${encodeURIComponent(args.path)}/exists`);
+                const response = await fetch(url.toString(), {
+                    headers: DEFAULT_HEADERS,
+                });
+                await handleGitLabError(response);
+                const data = await response.json();
+                const namespaceExists = GitLabNamespaceExistsResponseSchema.parse(data);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(namespaceExists, null, 2) }],
+                };
+            }
+            case "get_project": {
+                const args = GetProjectSchema.parse(request.params.arguments);
+                const url = new URL(`${GITLAB_API_URL}/projects/${encodeURIComponent(args.project_id)}`);
+                const response = await fetch(url.toString(), {
+                    headers: DEFAULT_HEADERS,
+                });
+                await handleGitLabError(response);
+                const data = await response.json();
+                const project = GitLabProjectSchema.parse(data);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(project, null, 2) }],
+                };
+            }
+            case "list_projects": {
+                const args = ListProjectsSchema.parse(request.params.arguments);
+                const url = new URL(`${GITLAB_API_URL}/projects`);
+                // Add query parameters for filtering
+                Object.entries(args).forEach(([key, value]) => {
+                    if (value !== undefined) {
+                        url.searchParams.append(key, value.toString());
+                    }
+                });
+                const response = await fetch(url.toString(), {
+                    headers: DEFAULT_HEADERS,
+                });
+                await handleGitLabError(response);
+                const data = await response.json();
+                const projects = z.array(GitLabProjectSchema).parse(data);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(projects, null, 2) }],
+                };
+            }
             case "create_note": {
                 const args = CreateNoteSchema.parse(request.params.arguments);
                 const { project_id, noteable_type, noteable_iid, body } = args;
@@ -759,6 +1187,64 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     content: [{ type: "text", text: JSON.stringify(note, null, 2) }],
                 };
             }
+            case "list_issues": {
+                const args = ListIssuesSchema.parse(request.params.arguments);
+                const { project_id, ...options } = args;
+                const issues = await listIssues(project_id, options);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(issues, null, 2) }],
+                };
+            }
+            case "get_issue": {
+                const args = GetIssueSchema.parse(request.params.arguments);
+                const issue = await getIssue(args.project_id, args.issue_iid);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(issue, null, 2) }],
+                };
+            }
+            case "update_issue": {
+                const args = UpdateIssueSchema.parse(request.params.arguments);
+                const { project_id, issue_iid, ...options } = args;
+                const issue = await updateIssue(project_id, issue_iid, options);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(issue, null, 2) }],
+                };
+            }
+            case "delete_issue": {
+                const args = DeleteIssueSchema.parse(request.params.arguments);
+                await deleteIssue(args.project_id, args.issue_iid);
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ status: "success", message: "Issue deleted successfully" }, null, 2) }],
+                };
+            }
+            case "list_issue_links": {
+                const args = ListIssueLinksSchema.parse(request.params.arguments);
+                const links = await listIssueLinks(args.project_id, args.issue_iid);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(links, null, 2) }],
+                };
+            }
+            case "get_issue_link": {
+                const args = GetIssueLinkSchema.parse(request.params.arguments);
+                const link = await getIssueLink(args.project_id, args.issue_iid, args.issue_link_id);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(link, null, 2) }],
+                };
+            }
+            case "create_issue_link": {
+                const args = CreateIssueLinkSchema.parse(request.params.arguments);
+                const link = await createIssueLink(args.project_id, args.issue_iid, args.target_project_id, args.target_issue_iid, args.link_type);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(link, null, 2) }],
+                };
+            }
+            case "delete_issue_link": {
+                const args = DeleteIssueLinkSchema.parse(request.params.arguments);
+                await deleteIssueLink(args.project_id, args.issue_iid, args.issue_link_id);
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ status: "success", message: "Issue link deleted successfully" }, null, 2) }],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${request.params.name}`);
         }

package/build/schemas.js

@@ -5,6 +5,31 @@ export const GitLabAuthorSchema = z.object({
     email: z.string(),
     date: z.string(),
 });
+// Namespace related schemas
+export const GitLabNamespaceSchema = z.object({
+    id: z.number(),
+    name: z.string(),
+    path: z.string(),
+    kind: z.enum(["user", "group"]),
+    full_path: z.string(),
+    parent_id: z.number().nullable(),
+    avatar_url: z.string().nullable(),
+    web_url: z.string(),
+    members_count_with_descendants: z.number().optional(),
+    billable_members_count: z.number().optional(),
+    max_seats_used: z.number().optional(),
+    seats_in_use: z.number().optional(),
+    plan: z.string().optional(),
+    end_date: z.string().nullable().optional(),
+    trial_ends_on: z.string().nullable().optional(),
+    trial: z.boolean().optional(),
+    root_repository_size: z.number().optional(),
+    projects_count: z.number().optional(),
+});
+export const GitLabNamespaceExistsResponseSchema = z.object({
+    exists: z.boolean(),
+    suggests: z.array(z.string()).optional(),
+});
 // Repository related schemas
 export const GitLabOwnerSchema = z.object({
     username: z.string(), // Changed from login to match GitLab API
@@ -28,7 +53,51 @@ export const GitLabRepositorySchema = z.object({
     created_at: z.string().optional(),
     last_activity_at: z.string().optional(),
     default_branch: z.string().optional(),
-});
+    namespace: z.object({
+        id: z.number(),
+        name: z.string(),
+        path: z.string(),
+        kind: z.string(),
+        full_path: z.string(),
+        avatar_url: z.string().nullable().optional(),
+        web_url: z.string().optional(),
+    }).optional(),
+    readme_url: z.string().optional().nullable(),
+    topics: z.array(z.string()).optional(),
+    tag_list: z.array(z.string()).optional(), // deprecated but still present
+    open_issues_count: z.number().optional(),
+    archived: z.boolean().optional(),
+    forks_count: z.number().optional(),
+    star_count: z.number().optional(),
+    permissions: z.object({
+        project_access: z.object({
+            access_level: z.number(),
+            notification_level: z.number().optional(),
+        }).optional().nullable(),
+        group_access: z.object({
+            access_level: z.number(),
+            notification_level: z.number().optional(),
+        }).optional().nullable(),
+    }).optional(),
+    container_registry_enabled: z.boolean().optional(),
+    container_registry_access_level: z.string().optional(),
+    issues_enabled: z.boolean().optional(),
+    merge_requests_enabled: z.boolean().optional(),
+    wiki_enabled: z.boolean().optional(),
+    jobs_enabled: z.boolean().optional(),
+    snippets_enabled: z.boolean().optional(),
+    can_create_merge_request_in: z.boolean().optional(),
+    resolve_outdated_diff_discussions: z.boolean().optional(),
+    shared_runners_enabled: z.boolean().optional(),
+    shared_with_groups: z.array(z.object({
+        group_id: z.number(),
+        group_name: z.string(),
+        group_full_path: z.string(),
+        group_access_level: z.number(),
+    })).optional(),
+});
+// Project schema (extended from repository schema)
+export const GitLabProjectSchema = GitLabRepositorySchema;
 // File content schemas
 export const GitLabFileContentSchema = z.object({
     file_name: z.string(), // Changed from name to match GitLab API
@@ -133,20 +202,6 @@ export const GitLabSearchResponseSchema = z.object({
     current_page: z.number().optional(),
     items: z.array(GitLabRepositorySchema),
 });
-// Fork related schemas
-export const GitLabForkParentSchema = z.object({
-    name: z.string(),
-    path_with_namespace: z.string(), // Changed from full_name to match GitLab API
-    owner: z.object({
-        username: z.string(), // Changed from login to match GitLab API
-        id: z.number(),
-        avatar_url: z.string(),
-    }).optional(), // Made optional to handle cases where GitLab API doesn't include it
-    web_url: z.string(), // Changed from html_url to match GitLab API
-});
-export const GitLabForkSchema = GitLabRepositorySchema.extend({
-    forked_from_project: GitLabForkParentSchema.optional(), // Made optional to handle cases where GitLab API doesn't include it
-});
 // Issue related schemas
 export const GitLabLabelSchema = z.object({
     id: z.number(),
@@ -178,12 +233,48 @@ export const GitLabIssueSchema = z.object({
     state: z.string(),
     author: GitLabUserSchema,
     assignees: z.array(GitLabUserSchema),
-    labels: z.array(GitLabLabelSchema),
+    labels: z.array(GitLabLabelSchema).or(z.array(z.string())), // Support both label objects and strings
     milestone: GitLabMilestoneSchema.nullable(),
     created_at: z.string(),
     updated_at: z.string(),
     closed_at: z.string().nullable(),
     web_url: z.string(), // Changed from html_url to match GitLab API
+    references: z.object({
+        short: z.string(),
+        relative: z.string(),
+        full: z.string(),
+    }).optional(),
+    time_stats: z.object({
+        time_estimate: z.number(),
+        total_time_spent: z.number(),
+        human_time_estimate: z.string().nullable(),
+        human_total_time_spent: z.string().nullable(),
+    }).optional(),
+    confidential: z.boolean().optional(),
+    due_date: z.string().nullable().optional(),
+    discussion_locked: z.boolean().nullable().optional(),
+    weight: z.number().nullable().optional(),
+});
+// NEW SCHEMA: For issue with link details (used in listing issue links)
+export const GitLabIssueWithLinkDetailsSchema = GitLabIssueSchema.extend({
+    issue_link_id: z.number(),
+    link_type: z.enum(['relates_to', 'blocks', 'is_blocked_by']),
+    link_created_at: z.string(),
+    link_updated_at: z.string(),
+});
+// Fork related schemas
+export const GitLabForkParentSchema = z.object({
+    name: z.string(),
+    path_with_namespace: z.string(), // Changed from full_name to match GitLab API
+    owner: z.object({
+        username: z.string(), // Changed from login to match GitLab API
+        id: z.number(),
+        avatar_url: z.string(),
+    }).optional(), // Made optional to handle cases where GitLab API doesn't include it
+    web_url: z.string(), // Changed from html_url to match GitLab API
+});
+export const GitLabForkSchema = GitLabRepositorySchema.extend({
+    forked_from_project: GitLabForkParentSchema.optional(), // Made optional to handle cases where GitLab API doesn't include it
 });
 // Merge Request related schemas (equivalent to Pull Request)
 export const GitLabMergeRequestDiffRefSchema = z.object({
@@ -364,3 +455,106 @@ export const CreateNoteSchema = z.object({
     noteable_iid: z.number().describe("IID of the issue or merge request"),
     body: z.string().describe("Note content"),
 });
+// Issues API operation schemas
+export const ListIssuesSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    assignee_id: z.number().optional().describe("Return issues assigned to the given user ID"),
+    assignee_username: z.string().optional().describe("Return issues assigned to the given username"),
+    author_id: z.number().optional().describe("Return issues created by the given user ID"),
+    author_username: z.string().optional().describe("Return issues created by the given username"),
+    confidential: z.boolean().optional().describe("Filter confidential or public issues"),
+    created_after: z.string().optional().describe("Return issues created after the given time"),
+    created_before: z.string().optional().describe("Return issues created before the given time"),
+    due_date: z.string().optional().describe("Return issues that have the due date"),
+    label_name: z.array(z.string()).optional().describe("Array of label names"),
+    milestone: z.string().optional().describe("Milestone title"),
+    scope: z.enum(['created-by-me', 'assigned-to-me', 'all']).optional().describe("Return issues from a specific scope"),
+    search: z.string().optional().describe("Search for specific terms"),
+    state: z.enum(['opened', 'closed', 'all']).optional().describe("Return issues with a specific state"),
+    updated_after: z.string().optional().describe("Return issues updated after the given time"),
+    updated_before: z.string().optional().describe("Return issues updated before the given time"),
+    with_labels_details: z.boolean().optional().describe("Return more details for each label"),
+    page: z.number().optional().describe("Page number for pagination"),
+    per_page: z.number().optional().describe("Number of items per page"),
+});
+export const GetIssueSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.number().describe("The internal ID of the project issue"),
+});
+export const UpdateIssueSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.number().describe("The internal ID of the project issue"),
+    title: z.string().optional().describe("The title of the issue"),
+    description: z.string().optional().describe("The description of the issue"),
+    assignee_ids: z.array(z.number()).optional().describe("Array of user IDs to assign issue to"),
+    confidential: z.boolean().optional().describe("Set the issue to be confidential"),
+    discussion_locked: z.boolean().optional().describe("Flag to lock discussions"),
+    due_date: z.string().optional().describe("Date the issue is due (YYYY-MM-DD)"),
+    labels: z.array(z.string()).optional().describe("Array of label names"),
+    milestone_id: z.number().optional().describe("Milestone ID to assign"),
+    state_event: z.enum(['close', 'reopen']).optional().describe("Update issue state (close/reopen)"),
+    weight: z.number().optional().describe("Weight of the issue (0-9)"),
+});
+export const DeleteIssueSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.number().describe("The internal ID of the project issue"),
+});
+// Issue links related schemas
+export const GitLabIssueLinkSchema = z.object({
+    source_issue: GitLabIssueSchema,
+    target_issue: GitLabIssueSchema,
+    link_type: z.enum(['relates_to', 'blocks', 'is_blocked_by']),
+});
+export const ListIssueLinksSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.number().describe("The internal ID of a project's issue"),
+});
+export const GetIssueLinkSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.number().describe("The internal ID of a project's issue"),
+    issue_link_id: z.number().describe("ID of an issue relationship"),
+});
+export const CreateIssueLinkSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.number().describe("The internal ID of a project's issue"),
+    target_project_id: z.string().describe("The ID or URL-encoded path of a target project"),
+    target_issue_iid: z.number().describe("The internal ID of a target project's issue"),
+    link_type: z.enum(['relates_to', 'blocks', 'is_blocked_by']).optional().describe("The type of the relation, defaults to relates_to"),
+});
+export const DeleteIssueLinkSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+    issue_iid: z.number().describe("The internal ID of a project's issue"),
+    issue_link_id: z.number().describe("The ID of an issue relationship"),
+});
+// Namespace API operation schemas
+export const ListNamespacesSchema = z.object({
+    search: z.string().optional().describe("Search term for namespaces"),
+    page: z.number().optional().describe("Page number for pagination"),
+    per_page: z.number().optional().describe("Number of items per page"),
+    owned: z.boolean().optional().describe("Filter for namespaces owned by current user"),
+});
+export const GetNamespaceSchema = z.object({
+    namespace_id: z.string().describe("Namespace ID or full path"),
+});
+export const VerifyNamespaceSchema = z.object({
+    path: z.string().describe("Namespace path to verify"),
+});
+// Project API operation schemas
+export const GetProjectSchema = z.object({
+    project_id: z.string().describe("Project ID or URL-encoded path"),
+});
+export const ListProjectsSchema = z.object({
+    search: z.string().optional().describe("Search term for projects"),
+    page: z.number().optional().describe("Page number for pagination"),
+    per_page: z.number().optional().describe("Number of items per page"),
+    owned: z.boolean().optional().describe("Filter for projects owned by current user"),
+    membership: z.boolean().optional().describe("Filter for projects where current user is a member"),
+    simple: z.boolean().optional().describe("Return only limited fields"),
+    archived: z.boolean().optional().describe("Filter for archived projects"),
+    visibility: z.enum(["public", "internal", "private"]).optional().describe("Filter by project visibility"),
+    order_by: z.enum(["id", "name", "path", "created_at", "updated_at", "last_activity_at"]).optional().describe("Return projects ordered by field"),
+    sort: z.enum(["asc", "desc"]).optional().describe("Return projects sorted in ascending or descending order"),
+    with_issues_enabled: z.boolean().optional().describe("Filter projects with issues feature enabled"),
+    with_merge_requests_enabled: z.boolean().optional().describe("Filter projects with merge requests feature enabled"),
+    min_access_level: z.number().optional().describe("Filter by minimum access level"),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",