@zereight/mcp-gitlab 1.0.17 → 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, GitLabNamespaceSchema, GitLabNamespaceExistsResponseSchema, CreateOrUpdateFileSchema, SearchRepositoriesSchema, CreateRepositorySchema, GetFileContentsSchema, PushFilesSchema, CreateIssueSchema, CreateMergeRequestSchema, ForkRepositorySchema, CreateBranchSchema, GitLabMergeRequestDiffSchema, GetMergeRequestSchema, GetMergeRequestDiffsSchema, UpdateMergeRequestSchema, ListNamespacesSchema, GetNamespaceSchema, VerifyNamespaceSchema, GetProjectSchema, ListProjectsSchema, 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
  * 병합 요청 생성
@@ -743,6 +908,46 @@ 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",
@@ -750,17 +955,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "get_namespace",
-                description: "Get details on a specified namespace",
+                description: "Get details of a namespace by ID or path",
                 inputSchema: zodToJsonSchema(GetNamespaceSchema),
             },
             {
                 name: "verify_namespace",
-                description: "Verify if a specified namespace already exists",
+                description: "Verify if a namespace path exists",
                 inputSchema: zodToJsonSchema(VerifyNamespaceSchema),
             },
             {
                 name: "get_project",
-                description: "Get details on a specified project",
+                description: "Get details of a specific project",
                 inputSchema: zodToJsonSchema(GetProjectSchema),
             },
             {
@@ -893,36 +1098,83 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "list_namespaces": {
                 const args = ListNamespacesSchema.parse(request.params.arguments);
-                const namespaces = await listNamespaces(args);
+                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 namespace = await getNamespace(args.id);
+                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 result = await verifyNamespaceExistence(args.namespace, args.parent_id);
+                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(result, null, 2) }],
+                    content: [{ type: "text", text: JSON.stringify(namespaceExists, null, 2) }],
                 };
             }
             case "get_project": {
                 const args = GetProjectSchema.parse(request.params.arguments);
-                const { id, ...options } = args;
-                const project = await getProject(id, options);
+                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 projects = await listProjects(args);
+                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) }],
                 };
@@ -935,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

@@ -96,6 +96,8 @@ export const GitLabRepositorySchema = z.object({
         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
@@ -200,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(),
@@ -245,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({
@@ -431,44 +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"),
 });
-// Add namespace-related operation schemas
+// 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("Only returns namespaces accessible by the current user"),
-    owned_only: z.boolean().optional().describe("If true, only returns namespaces by the current user"),
-    top_level_only: z.boolean().optional().describe("In GitLab 16.8 and later, if true, only returns top-level namespaces"),
+    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({
-    id: z.string().describe("ID or URL-encoded path of the namespace"),
+    namespace_id: z.string().describe("Namespace ID or full path"),
 });
 export const VerifyNamespaceSchema = z.object({
-    namespace: z.string().describe("Path of the namespace"),
-    parent_id: z.number().optional().describe("ID of the parent namespace. If unspecified, only returns top-level namespaces"),
+    path: z.string().describe("Namespace path to verify"),
 });
 // Project API operation schemas
 export const GetProjectSchema = z.object({
-    id: z.string().describe("ID or URL-encoded path of the project"),
-    license: z.boolean().optional().describe("Include project license data"),
-    statistics: z.boolean().optional().describe("Include project statistics"),
-    with_custom_attributes: z.boolean().optional().describe("Include custom attributes in response"),
+    project_id: z.string().describe("Project ID or URL-encoded path"),
 });
 export const ListProjectsSchema = z.object({
-    archived: z.boolean().optional().describe("Limit by archived status"),
-    id_after: z.number().optional().describe("Limit results to projects with IDs greater than the specified ID"),
-    id_before: z.number().optional().describe("Limit results to projects with IDs less than the specified ID"),
-    membership: z.boolean().optional().describe("Limit by projects that the current user is a member of"),
-    min_access_level: z.number().optional().describe("Limit by minimum access level"),
-    order_by: z.enum(['id', 'name', 'path', 'created_at', 'updated_at', 'last_activity_at']).optional().describe("Return projects ordered by field"),
-    owned: z.boolean().optional().describe("Limit by projects explicitly owned by the current user"),
-    search: z.string().optional().describe("Return list of projects matching the search criteria"),
-    simple: z.boolean().optional().describe("Return only limited fields for each project"),
-    sort: z.enum(['asc', 'desc']).optional().describe("Return projects sorted in ascending or descending order"),
-    starred: z.boolean().optional().describe("Limit by projects starred by the current user"),
-    visibility: z.enum(['public', 'internal', 'private']).optional().describe("Limit by visibility"),
-    with_custom_attributes: z.boolean().optional().describe("Include custom attributes in response"),
-    with_issues_enabled: z.boolean().optional().describe("Limit by enabled issues feature"),
-    with_merge_requests_enabled: z.boolean().optional().describe("Limit by enabled merge requests feature"),
-    with_programming_language: z.string().optional().describe("Limit by projects which use the given programming language"),
-    with_shared: z.boolean().optional().describe("Include projects shared to this group"),
+    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.17",
+  "version": "1.0.18",
   "description": "MCP server for using the GitLab API",
   "license": "MIT",
   "author": "zereight",