@templmf/temp-solf-lmf 0.0.40 → 0.0.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@templmf/temp-solf-lmf",
-  "version": "0.0.40",
+  "version": "0.0.41",
   "description": "",
   "main": "index.js",
   "scripts": {

package/test.txt

@@ -0,0 +1,648 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import axios, { AxiosInstance } from "axios";
+import { z } from "zod";
+
+// ─── Config ───────────────────────────────────────────────────────────────────
+const GITLAB_URL = process.env.GITLAB_API_URL || "http://localhost/api/v3";
+const TOKEN = process.env.GITLAB_PRIVATE_TOKEN || process.env.GITLAB_PERSONAL_ACCESS_TOKEN || "";
+
+if (!TOKEN) {
+  process.stderr.write(
+    "Error: GITLAB_PRIVATE_TOKEN or GITLAB_PERSONAL_ACCESS_TOKEN environment variable is required\n"
+  );
+  process.exit(1);
+}
+
+// ─── API Client ───────────────────────────────────────────────────────────────
+const api: AxiosInstance = axios.create({
+  baseURL: GITLAB_URL,
+  headers: { "PRIVATE-TOKEN": TOKEN },
+  timeout: 30000,
+});
+
+// Ignore self-signed certs for internal GitLab
+if (process.env.NODE_TLS_REJECT_UNAUTHORIZED === "0") {
+  process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
+}
+
+async function gitlabGet<T>(path: string, params?: Record<string, unknown>): Promise<T> {
+  try {
+    const res = await api.get<T>(path, { params });
+    return res.data;
+  } catch (err: unknown) {
+    if (axios.isAxiosError(err)) {
+      const status = err.response?.status;
+      const msg = (err.response?.data as { message?: string })?.message || err.message;
+      throw new Error(`GitLab API error ${status}: ${msg}`);
+    }
+    throw err;
+  }
+}
+
+async function gitlabPost<T>(path: string, data?: Record<string, unknown>): Promise<T> {
+  try {
+    const res = await api.post<T>(path, data);
+    return res.data;
+  } catch (err: unknown) {
+    if (axios.isAxiosError(err)) {
+      const status = err.response?.status;
+      const msg = (err.response?.data as { message?: string })?.message || err.message;
+      throw new Error(`GitLab API error ${status}: ${msg}`);
+    }
+    throw err;
+  }
+}
+
+async function gitlabPut<T>(path: string, data?: Record<string, unknown>): Promise<T> {
+  try {
+    const res = await api.put<T>(path, data);
+    return res.data;
+  } catch (err: unknown) {
+    if (axios.isAxiosError(err)) {
+      const status = err.response?.status;
+      const msg = (err.response?.data as { message?: string })?.message || err.message;
+      throw new Error(`GitLab API error ${status}: ${msg}`);
+    }
+    throw err;
+  }
+}
+
+function text(content: unknown): { content: Array<{ type: "text"; text: string }> } {
+  return {
+    content: [{ type: "text", text: JSON.stringify(content, null, 2) }],
+  };
+}
+
+// ─── MCP Server ───────────────────────────────────────────────────────────────
+const server = new McpServer({
+  name: "gitlab-v3-mcp-server",
+  version: "1.0.0",
+});
+
+// ── Projects ──────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "gitlab_list_projects",
+  {
+    title: "List Projects",
+    description: "List GitLab projects accessible to the current user.",
+    inputSchema: {
+      search: z.string().optional().describe("Search keyword"),
+      page: z.number().int().min(1).default(1).describe("Page number"),
+      per_page: z.number().int().min(1).max(100).default(20).describe("Results per page"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ search, page, per_page }) => {
+    const data = await gitlabGet("/projects", { search, page, per_page });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_get_project",
+  {
+    title: "Get Project",
+    description: "Get details of a specific project by ID or namespace/name (e.g. 'group/repo').",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}`);
+    return text(data);
+  }
+);
+
+// ── Repository ────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "gitlab_list_branches",
+  {
+    title: "List Branches",
+    description: "List all branches of a project.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/repository/branches`);
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_get_file",
+  {
+    title: "Get File Content",
+    description: "Get the content of a file from a project repository.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      file_path: z.string().describe("Path to file, e.g. 'src/index.js'"),
+      ref: z.string().default("master").describe("Branch, tag or commit SHA"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, file_path, ref }) => {
+    const id = encodeURIComponent(String(project_id));
+    const fp = encodeURIComponent(file_path);
+    const data = await gitlabGet(`/projects/${id}/repository/files`, { file_path: fp, ref });
+    // Decode base64 content
+    type FileData = { content?: string; encoding?: string; [key: string]: unknown };
+    const fd = data as FileData;
+    if (fd.content && fd.encoding === "base64") {
+      fd.content = Buffer.from(fd.content, "base64").toString("utf-8");
+      fd.encoding = "utf-8 (decoded)";
+    }
+    return text(fd);
+  }
+);
+
+server.registerTool(
+  "gitlab_list_commits",
+  {
+    title: "List Commits",
+    description: "List commits in a project repository.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      ref_name: z.string().optional().describe("Branch or tag name"),
+      page: z.number().int().min(1).default(1).describe("Page number"),
+      per_page: z.number().int().min(1).max(100).default(20).describe("Results per page"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, ref_name, page, per_page }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/repository/commits`, { ref_name, page, per_page });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_list_tree",
+  {
+    title: "List Repository Tree",
+    description: "List files and directories in a project repository path.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      path: z.string().optional().describe("Directory path, empty for root"),
+      ref_name: z.string().optional().describe("Branch or tag name"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, path, ref_name }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/repository/tree`, { path, ref_name });
+    return text(data);
+  }
+);
+
+// ── Issues ────────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "gitlab_list_issues",
+  {
+    title: "List Issues",
+    description: "List issues in a project.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      state: z.enum(["opened", "closed"]).optional().describe("Filter by state"),
+      labels: z.string().optional().describe("Comma-separated list of labels"),
+      page: z.number().int().min(1).default(1).describe("Page number"),
+      per_page: z.number().int().min(1).max(100).default(20).describe("Results per page"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, state, labels, page, per_page }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/issues`, { state, labels, page, per_page });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_get_issue",
+  {
+    title: "Get Issue",
+    description: "Get details of a specific issue.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      issue_id: z.number().int().describe("Issue IID (project-level issue number)"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, issue_id }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/issues/${issue_id}`);
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_create_issue",
+  {
+    title: "Create Issue",
+    description: "Create a new issue in a project.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      title: z.string().min(1).describe("Issue title"),
+      description: z.string().optional().describe("Issue description (Markdown supported)"),
+      labels: z.string().optional().describe("Comma-separated labels"),
+      assignee_id: z.number().int().optional().describe("User ID to assign"),
+    },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+  },
+  async ({ project_id, title, description, labels, assignee_id }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabPost(`/projects/${id}/issues`, {
+      title,
+      description,
+      labels,
+      assignee_id,
+    });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_add_issue_comment",
+  {
+    title: "Add Issue Comment",
+    description: "Add a comment (note) to an issue.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      issue_id: z.number().int().describe("Issue IID"),
+      body: z.string().min(1).describe("Comment text (Markdown supported)"),
+    },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+  },
+  async ({ project_id, issue_id, body }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabPost(`/projects/${id}/issues/${issue_id}/notes`, { body });
+    return text(data);
+  }
+);
+
+// ── Merge Requests ────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "gitlab_list_merge_requests",
+  {
+    title: "List Merge Requests",
+    description: "List merge requests in a project.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      state: z.enum(["opened", "closed", "merged"]).optional().describe("Filter by state"),
+      page: z.number().int().min(1).default(1).describe("Page number"),
+      per_page: z.number().int().min(1).max(100).default(20).describe("Results per page"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, state, page, per_page }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/merge_requests`, { state, page, per_page });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_get_merge_request",
+  {
+    title: "Get Merge Request",
+    description: "Get details of a specific merge request.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      mr_id: z.number().int().describe("Merge request IID"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, mr_id }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/merge_requests`, { iid: mr_id });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_get_merge_request_changes",
+  {
+    title: "Get Merge Request Changes",
+    description: "Get file changes (diffs) for a merge request by its IID (e.g. #26). Internally resolves the real mr id via GET /projects/:id/merge_requests?iid=:merge_iid, then fetches changes via GET /projects/:id/merge_requests/:mr_id/changes.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      merge_iid: z.number().int().describe("The merge request IID shown in the UI (e.g. 26 for !26)"),
+      raw_diff: z.boolean().optional().default(false).describe("If true, returns only file path info + unified diff per file, omitting MR metadata"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, merge_iid, raw_diff }) => {
+    const id = encodeURIComponent(String(project_id));
+
+    type MRItem = {
+      id: number;
+      iid: number;
+      title: string;
+      [key: string]: unknown;
+    };
+
+    type MRChange = {
+      old_path: string;
+      new_path: string;
+      new_file: boolean;
+      renamed_file: boolean;
+      deleted_file: boolean;
+      diff: string;
+    };
+
+    type MRChangesResponse = {
+      id: number;
+      iid: number;
+      title: string;
+      changes: MRChange[];
+      [key: string]: unknown;
+    };
+
+    // Step 1: resolve iid → real id
+    const mrList = await gitlabGet<MRItem[]>(`/projects/${id}/merge_requests`, { iid: merge_iid });
+    if (!mrList || mrList.length === 0) {
+      return text({ error: `No merge request found for iid=${merge_iid}` });
+    }
+    const mrRequestId = mrList[0].id;
+
+    // Step 2: fetch changes using the real id
+    const data = await gitlabGet<MRChangesResponse>(
+      `/projects/${id}/merge_requests/${mrRequestId}/changes`
+    );
+
+    if (raw_diff) {
+      return text(
+        (data.changes ?? []).map((c: MRChange) => ({
+          old_path: c.old_path,
+          new_path: c.new_path,
+          new_file: c.new_file,
+          renamed_file: c.renamed_file,
+          deleted_file: c.deleted_file,
+          diff: c.diff,
+        }))
+      );
+    }
+
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_create_merge_request",
+  {
+    title: "Create Merge Request",
+    description: "Create a new merge request.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      title: z.string().min(1).describe("MR title"),
+      source_branch: z.string().describe("Source branch name"),
+      target_branch: z.string().describe("Target branch name"),
+      description: z.string().optional().describe("MR description"),
+      assignee_id: z.number().int().optional().describe("User ID to assign"),
+    },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+  },
+  async ({ project_id, title, source_branch, target_branch, description, assignee_id }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabPost(`/projects/${id}/merge_requests`, {
+      title,
+      source_branch,
+      target_branch,
+      description,
+      assignee_id,
+    });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_update_merge_request",
+  {
+    title: "Update Merge Request",
+    description: "Update an existing merge request. Can change target branch, title, assignee, description, labels, milestone, or close the MR. Internally resolves the iid to the real merge_request_id via GET /projects/:id/merge_requests?iid=:merge_iid, then calls PUT /projects/:id/merge_requests/:merge_request_id.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      merge_iid: z.number().int().describe("The merge request IID shown in the UI (e.g. 26 for !26)"),
+      title: z.string().min(1).optional().describe("Title of MR"),
+      source_branch: z.string().optional().describe("The source branch"),
+      target_branch: z.string().optional().describe("The target branch"),
+      assignee_id: z.number().int().optional().describe("Assignee user ID"),
+      description: z.string().optional().describe("Description of MR"),
+      target_project_id: z.number().int().optional().describe("The target project numeric ID"),
+      labels: z.string().optional().describe("Labels for MR as a comma-separated list"),
+      milestone_id: z.number().int().optional().describe("The ID of a milestone"),
+      remove_source_branch: z.boolean().optional().describe("Flag indicating if a merge request should remove the source branch when merging"),
+    },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, merge_iid, title, source_branch, target_branch, assignee_id, description, target_project_id, labels, milestone_id, remove_source_branch }) => {
+    const id = encodeURIComponent(String(project_id));
+
+    type MRItem = { id: number; iid: number; [key: string]: unknown };
+
+    // Step 1: resolve iid → real merge_request_id
+    const mrList = await gitlabGet<MRItem[]>(`/projects/${id}/merge_requests`, { iid: merge_iid });
+    if (!mrList || mrList.length === 0) {
+      return text({ error: `No merge request found for iid=${merge_iid}` });
+    }
+    const mergeRequestId = mrList[0].id;
+
+    // Step 2: update the MR
+    const data = await gitlabPut(`/projects/${id}/merge_requests/${mergeRequestId}`, {
+      title,
+      source_branch,
+      target_branch,
+      assignee_id,
+      description,
+      target_project_id,
+      labels,
+      milestone_id,
+      remove_source_branch,
+    });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_accept_merge_request",
+  {
+    title: "Accept Merge Request",
+    description: "Accept (merge) a merge request by its IID. Internally resolves the iid to the real merge_request_id via GET /projects/:id/merge_requests?iid=:merge_iid, then calls PUT /projects/:id/merge_requests/:merge_request_id/merge.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      merge_iid: z.number().int().describe("The merge request IID shown in the UI (e.g. 26 for !26)"),
+      merge_commit_message: z.string().optional().describe("Custom merge commit message"),
+      should_remove_source_branch: z.boolean().optional().describe("If true, removes the source branch after merge"),
+      merge_when_build_succeeds: z.boolean().optional().describe("If true, merges only when the build succeeds"),
+      sha: z.string().optional().describe("If present, must match HEAD of the source branch or the merge will fail"),
+    },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+  },
+  async ({ project_id, merge_iid, merge_commit_message, should_remove_source_branch, merge_when_build_succeeds, sha }) => {
+    const id = encodeURIComponent(String(project_id));
+
+    type MRItem = { id: number; iid: number; [key: string]: unknown };
+
+    // Step 1: resolve iid → real merge_request_id
+    const mrList = await gitlabGet<MRItem[]>(`/projects/${id}/merge_requests`, { iid: merge_iid });
+    if (!mrList || mrList.length === 0) {
+      return text({ error: `No merge request found for iid=${merge_iid}` });
+    }
+    const mergeRequestId = mrList[0].id;
+
+    // Step 2: accept the MR
+    const data = await gitlabPut(`/projects/${id}/merge_requests/${mergeRequestId}/merge`, {
+      merge_commit_message,
+      should_remove_source_branch,
+      merge_when_build_succeeds,
+      sha,
+    });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_add_merge_request_comment",
+  {
+    title: "Add Merge Request Comment",
+    description: "Add a comment (note) to a merge request by its IID. Internally resolves the iid to the real merge_request_id via GET /projects/:id/merge_requests?iid=:merge_iid, then calls POST /projects/:id/merge_requests/:merge_request_id/notes.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      merge_iid: z.number().int().describe("The merge request IID shown in the UI (e.g. 26 for !26)"),
+      body: z.string().min(1).describe("Comment text (Markdown supported)"),
+    },
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+  },
+  async ({ project_id, merge_iid, body }) => {
+    const id = encodeURIComponent(String(project_id));
+
+    type MRItem = { id: number; iid: number; [key: string]: unknown };
+
+    // Step 1: resolve iid → real merge_request_id
+    const mrList = await gitlabGet<MRItem[]>(`/projects/${id}/merge_requests`, { iid: merge_iid });
+    if (!mrList || mrList.length === 0) {
+      return text({ error: `No merge request found for iid=${merge_iid}` });
+    }
+    const mergeRequestId = mrList[0].id;
+
+    // Step 2: post the comment
+    const data = await gitlabPost(`/projects/${id}/merge_requests/${mergeRequestId}/notes`, { body });
+    return text(data);
+  }
+);
+
+// ── Users ─────────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "gitlab_get_current_user",
+  {
+    title: "Get Current User",
+    description: "Get details of the currently authenticated user.",
+    inputSchema: {},
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async () => {
+    const data = await gitlabGet("/user");
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_list_project_members",
+  {
+    title: "List Project Members",
+    description: "List members of a project.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id }) => {
+    const id = encodeURIComponent(String(project_id));
+    const data = await gitlabGet(`/projects/${id}/members`);
+    return text(data);
+  }
+);
+
+// ── Groups ────────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "gitlab_list_groups",
+  {
+    title: "List Groups",
+    description: "List all groups accessible to the current user.",
+    inputSchema: {
+      search: z.string().optional().describe("Search keyword"),
+      page: z.number().int().min(1).default(1).describe("Page number"),
+      per_page: z.number().int().min(1).max(100).default(20).describe("Results per page"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ search, page, per_page }) => {
+    const data = await gitlabGet("/groups", { search, page, per_page });
+    return text(data);
+  }
+);
+
+server.registerTool(
+  "gitlab_list_group_projects",
+  {
+    title: "List Group Projects",
+    description: "List all projects in a group.",
+    inputSchema: {
+      group_id: z.union([z.number(), z.string()]).describe("Group ID or group path"),
+      page: z.number().int().min(1).default(1).describe("Page number"),
+      per_page: z.number().int().min(1).max(100).default(20).describe("Results per page"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ group_id, page, per_page }) => {
+    const id = encodeURIComponent(String(group_id));
+    const data = await gitlabGet(`/groups/${id}/projects`, { page, per_page });
+    return text(data);
+  }
+);
+
+// ── Search ────────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "gitlab_search_code",
+  {
+    title: "Search Code in Project",
+    description: "Search for code within a project repository.",
+    inputSchema: {
+      project_id: z.union([z.number(), z.string()]).describe("Project ID or 'namespace/project_name'"),
+      query: z.string().min(1).describe("Search query string"),
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+  },
+  async ({ project_id, query }) => {
+    const id = encodeURIComponent(String(project_id));
+    // GitLab v3 search endpoint
+    const data = await gitlabGet(`/projects/${id}/search`, { scope: "blobs", search: query });
+    return text(data);
+  }
+);
+
+// ─── Start Server ─────────────────────────────────────────────────────────────
+async function main(): Promise<void> {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  process.stderr.write(`GitLab v3 MCP Server started. Connected to: ${GITLAB_URL}\n`);
+}
+
+main().catch((err: unknown) => {
+  process.stderr.write(`Fatal error: ${err}\n`);
+  process.exit(1);
+});