gitlab-mb-mcp 0.1.0__tar.gz

gitlab_mb_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: gitlab-mb-mcp
+Version: 0.1.0
+Summary: GitLab MCP server — projects, MRs, commits, files, issues
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.0.0

gitlab_mb_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gitlab-mb-mcp"
+version = "0.1.0"
+description = "GitLab MCP server — projects, MRs, commits, files, issues"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp[cli]>=1.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+gitlab-mb-mcp = "gitlab_mb_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gitlab_mb_mcp"]

gitlab_mb_mcp-0.1.0/src/gitlab_mb_mcp/gitlab.py

@@ -0,0 +1,142 @@
+import os
+import httpx
+from typing import Any
+
+
+class GitLabClient:
+    def __init__(self):
+        self.base_url = os.environ["GITLAB_API_URL"].rstrip("/")
+        self.token = os.environ["GITLAB_PERSONAL_ACCESS_TOKEN"]
+        self._client = httpx.AsyncClient(
+            headers={"PRIVATE-TOKEN": self.token},
+            timeout=30.0,
+        )
+
+    async def get(self, path: str, params: dict | None = None) -> Any:
+        url = f"{self.base_url}{path}"
+        r = await self._client.get(url, params=params)
+        r.raise_for_status()
+        return r.json()
+
+    async def post(self, path: str, json: dict | None = None) -> Any:
+        url = f"{self.base_url}{path}"
+        r = await self._client.post(url, json=json)
+        r.raise_for_status()
+        return r.json()
+
+    async def put(self, path: str, json: dict | None = None) -> Any:
+        url = f"{self.base_url}{path}"
+        r = await self._client.put(url, json=json)
+        r.raise_for_status()
+        return r.json()
+
+    # ── Projects ──────────────────────────────────────────────────────────────
+
+    async def search_projects(self, search: str = "", per_page: int = 20) -> list:
+        return await self.get("/projects", {"search": search, "per_page": per_page, "order_by": "last_activity_at"})
+
+    async def get_project(self, project_id: str) -> dict:
+        return await self.get(f"/projects/{_enc(project_id)}")
+
+    # ── Merge Requests ────────────────────────────────────────────────────────
+
+    async def list_mrs(self, project_id: str, state: str = "opened", per_page: int = 20) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/merge_requests", {"state": state, "per_page": per_page})
+
+    async def get_mr(self, project_id: str, mr_iid: int) -> dict:
+        return await self.get(f"/projects/{_enc(project_id)}/merge_requests/{mr_iid}")
+
+    async def get_mr_diffs(self, project_id: str, mr_iid: int) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/merge_requests/{mr_iid}/diffs", {"per_page": 100})
+
+    async def get_mr_commits(self, project_id: str, mr_iid: int) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/merge_requests/{mr_iid}/commits")
+
+    async def create_mr(self, project_id: str, source_branch: str, target_branch: str,
+                        title: str, description: str = "") -> dict:
+        return await self.post(f"/projects/{_enc(project_id)}/merge_requests", {
+            "source_branch": source_branch,
+            "target_branch": target_branch,
+            "title": title,
+            "description": description,
+        })
+
+    async def merge_mr(self, project_id: str, mr_iid: int) -> dict:
+        return await self.put(f"/projects/{_enc(project_id)}/merge_requests/{mr_iid}/merge")
+
+    async def add_mr_note(self, project_id: str, mr_iid: int, body: str) -> dict:
+        return await self.post(f"/projects/{_enc(project_id)}/merge_requests/{mr_iid}/notes", {"body": body})
+
+    async def get_mr_notes(self, project_id: str, mr_iid: int) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/merge_requests/{mr_iid}/notes")
+
+    # ── Commits ───────────────────────────────────────────────────────────────
+
+    async def list_commits(self, project_id: str, ref: str = "HEAD", per_page: int = 20) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/repository/commits",
+                              {"ref_name": ref, "per_page": per_page})
+
+    async def get_commit(self, project_id: str, sha: str) -> dict:
+        return await self.get(f"/projects/{_enc(project_id)}/repository/commits/{sha}")
+
+    async def get_commit_diffs(self, project_id: str, sha: str) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/repository/commits/{sha}/diff")
+
+    # ── Files & Tree ──────────────────────────────────────────────────────────
+
+    async def get_file(self, project_id: str, file_path: str, ref: str = "HEAD") -> dict:
+        enc_path = file_path.replace("/", "%2F")
+        return await self.get(f"/projects/{_enc(project_id)}/repository/files/{enc_path}",
+                              {"ref": ref})
+
+    async def list_tree(self, project_id: str, path: str = "", ref: str = "HEAD",
+                        recursive: bool = False) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/repository/tree",
+                              {"path": path, "ref": ref, "recursive": recursive, "per_page": 100})
+
+    # ── Issues ────────────────────────────────────────────────────────────────
+
+    async def list_issues(self, project_id: str, state: str = "opened", per_page: int = 20) -> list:
+        return await self.get(f"/projects/{_enc(project_id)}/issues",
+                              {"state": state, "per_page": per_page})
+
+    async def get_issue(self, project_id: str, issue_iid: int) -> dict:
+        return await self.get(f"/projects/{_enc(project_id)}/issues/{issue_iid}")
+
+    async def create_issue(self, project_id: str, title: str, description: str = "") -> dict:
+        return await self.post(f"/projects/{_enc(project_id)}/issues",
+                               {"title": title, "description": description})
+
+    async def add_issue_note(self, project_id: str, issue_iid: int, body: str) -> dict:
+        return await self.post(f"/projects/{_enc(project_id)}/issues/{issue_iid}/notes",
+                               {"body": body})
+
+    # ── Branches ──────────────────────────────────────────────────────────────
+
+    async def list_branches(self, project_id: str, search: str = "") -> list:
+        params: dict = {"per_page": 50}
+        if search:
+            params["search"] = search
+        return await self.get(f"/projects/{_enc(project_id)}/repository/branches", params)
+
+    async def create_branch(self, project_id: str, branch: str, ref: str) -> dict:
+        return await self.post(f"/projects/{_enc(project_id)}/repository/branches",
+                               {"branch": branch, "ref": ref})
+
+    # ── Pipelines ─────────────────────────────────────────────────────────────
+
+    async def list_pipelines(self, project_id: str, ref: str = "", per_page: int = 20) -> list:
+        params: dict = {"per_page": per_page}
+        if ref:
+            params["ref"] = ref
+        return await self.get(f"/projects/{_enc(project_id)}/pipelines", params)
+
+    async def get_pipeline(self, project_id: str, pipeline_id: int) -> dict:
+        return await self.get(f"/projects/{_enc(project_id)}/pipelines/{pipeline_id}")
+
+    async def aclose(self):
+        await self._client.aclose()
+
+
+def _enc(project_id: str) -> str:
+    return project_id.replace("/", "%2F")

gitlab_mb_mcp-0.1.0/src/gitlab_mb_mcp/server.py

@@ -0,0 +1,265 @@
+import base64
+import json
+from mcp.server.fastmcp import FastMCP
+from gitlab_mb_mcp.gitlab import GitLabClient
+
+mcp = FastMCP("gitlab-mb-mcp")
+gl: GitLabClient | None = None
+
+
+def _gl() -> GitLabClient:
+    global gl
+    if gl is None:
+        gl = GitLabClient()
+    return gl
+
+
+def _json(data) -> str:
+    return json.dumps(data, ensure_ascii=False, indent=2)
+
+
+# ── Projects ──────────────────────────────────────────────────────────────────
+
+@mcp.tool()
+async def search_projects(search: str = "", per_page: int = 20) -> str:
+    """Search GitLab projects. Returns id, name, path_with_namespace, last_activity_at."""
+    data = await _gl().search_projects(search=search, per_page=per_page)
+    rows = [
+        {"id": p["id"], "path": p["path_with_namespace"],
+         "name": p["name"], "last_activity": p.get("last_activity_at", "")}
+        for p in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def get_project(project_id: str) -> str:
+    """Get project details by id or path (e.g. 'group/repo')."""
+    return _json(await _gl().get_project(project_id))
+
+
+# ── Merge Requests ────────────────────────────────────────────────────────────
+
+@mcp.tool()
+async def list_merge_requests(project_id: str, state: str = "opened", per_page: int = 20) -> str:
+    """List merge requests. state: opened | closed | merged | all."""
+    data = await _gl().list_mrs(project_id, state=state, per_page=per_page)
+    rows = [
+        {"iid": mr["iid"], "title": mr["title"], "state": mr["state"],
+         "author": mr["author"]["username"], "source_branch": mr["source_branch"],
+         "target_branch": mr["target_branch"], "web_url": mr["web_url"]}
+        for mr in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def get_merge_request(project_id: str, mr_iid: int) -> str:
+    """Get full details of a merge request by its IID."""
+    return _json(await _gl().get_mr(project_id, mr_iid))
+
+
+@mcp.tool()
+async def get_merge_request_diffs(project_id: str, mr_iid: int) -> str:
+    """Get list of changed files (diffs) in a merge request.
+    Returns file paths and unified diffs."""
+    data = await _gl().get_mr_diffs(project_id, mr_iid)
+    result = []
+    for d in data:
+        result.append({
+            "old_path": d.get("old_path"),
+            "new_path": d.get("new_path"),
+            "new_file": d.get("new_file"),
+            "deleted_file": d.get("deleted_file"),
+            "renamed_file": d.get("renamed_file"),
+            "diff": d.get("diff", ""),
+        })
+    return _json(result)
+
+
+@mcp.tool()
+async def get_merge_request_commits(project_id: str, mr_iid: int) -> str:
+    """Get list of commits included in a merge request."""
+    data = await _gl().get_mr_commits(project_id, mr_iid)
+    rows = [
+        {"id": c["id"][:10], "title": c["title"],
+         "author": c["author_name"], "date": c["created_at"]}
+        for c in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def get_merge_request_notes(project_id: str, mr_iid: int) -> str:
+    """Get all comments (notes) of a merge request."""
+    data = await _gl().get_mr_notes(project_id, mr_iid)
+    rows = [
+        {"id": n["id"], "author": n["author"]["username"],
+         "body": n["body"], "created_at": n["created_at"]}
+        for n in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def create_merge_request(project_id: str, source_branch: str,
+                                target_branch: str, title: str,
+                                description: str = "") -> str:
+    """Create a new merge request."""
+    return _json(await _gl().create_mr(project_id, source_branch, target_branch, title, description))
+
+
+@mcp.tool()
+async def merge_merge_request(project_id: str, mr_iid: int) -> str:
+    """Merge an open merge request."""
+    return _json(await _gl().merge_mr(project_id, mr_iid))
+
+
+@mcp.tool()
+async def add_merge_request_comment(project_id: str, mr_iid: int, body: str) -> str:
+    """Add a comment to a merge request."""
+    return _json(await _gl().add_mr_note(project_id, mr_iid, body))
+
+
+# ── Commits ───────────────────────────────────────────────────────────────────
+
+@mcp.tool()
+async def list_commits(project_id: str, ref: str = "HEAD", per_page: int = 20) -> str:
+    """List commits in a project branch/ref."""
+    data = await _gl().list_commits(project_id, ref=ref, per_page=per_page)
+    rows = [
+        {"id": c["id"][:10], "title": c["title"],
+         "author": c["author_name"], "date": c["created_at"]}
+        for c in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def get_commit(project_id: str, sha: str) -> str:
+    """Get commit details by SHA (full or short)."""
+    return _json(await _gl().get_commit(project_id, sha))
+
+
+@mcp.tool()
+async def get_commit_diffs(project_id: str, sha: str) -> str:
+    """Get file diffs (changes) for a specific commit."""
+    data = await _gl().get_commit_diffs(project_id, sha)
+    result = []
+    for d in data:
+        result.append({
+            "old_path": d.get("old_path"),
+            "new_path": d.get("new_path"),
+            "new_file": d.get("new_file"),
+            "deleted_file": d.get("deleted_file"),
+            "diff": d.get("diff", ""),
+        })
+    return _json(result)
+
+
+# ── Files & Tree ──────────────────────────────────────────────────────────────
+
+@mcp.tool()
+async def get_file_contents(project_id: str, file_path: str, ref: str = "HEAD") -> str:
+    """Get file contents from the repository at a given ref (branch/tag/commit SHA).
+    file_path example: 'src/main.py'"""
+    data = await _gl().get_file(project_id, file_path, ref=ref)
+    content_b64 = data.get("content", "")
+    encoding = data.get("encoding", "base64")
+    if encoding == "base64":
+        content = base64.b64decode(content_b64).decode("utf-8", errors="replace")
+    else:
+        content = content_b64
+    return content
+
+
+@mcp.tool()
+async def list_repository_tree(project_id: str, path: str = "",
+                                ref: str = "HEAD", recursive: bool = False) -> str:
+    """List files and directories in the repository.
+    path: subdirectory to list (empty = root). recursive: expand all subdirs."""
+    data = await _gl().list_tree(project_id, path=path, ref=ref, recursive=recursive)
+    rows = [{"type": n["type"], "path": n["path"], "name": n["name"]} for n in data]
+    return _json(rows)
+
+
+# ── Issues ────────────────────────────────────────────────────────────────────
+
+@mcp.tool()
+async def list_issues(project_id: str, state: str = "opened", per_page: int = 20) -> str:
+    """List project issues. state: opened | closed | all."""
+    data = await _gl().list_issues(project_id, state=state, per_page=per_page)
+    rows = [
+        {"iid": i["iid"], "title": i["title"], "state": i["state"],
+         "author": i["author"]["username"], "web_url": i["web_url"]}
+        for i in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def get_issue(project_id: str, issue_iid: int) -> str:
+    """Get full details of an issue by its IID."""
+    return _json(await _gl().get_issue(project_id, issue_iid))
+
+
+@mcp.tool()
+async def create_issue(project_id: str, title: str, description: str = "") -> str:
+    """Create a new issue in the project."""
+    return _json(await _gl().create_issue(project_id, title, description))
+
+
+@mcp.tool()
+async def add_issue_comment(project_id: str, issue_iid: int, body: str) -> str:
+    """Add a comment to an issue."""
+    return _json(await _gl().add_issue_note(project_id, issue_iid, body))
+
+
+# ── Branches ──────────────────────────────────────────────────────────────────
+
+@mcp.tool()
+async def list_branches(project_id: str, search: str = "") -> str:
+    """List repository branches. Optionally filter by search string."""
+    data = await _gl().list_branches(project_id, search=search)
+    rows = [
+        {"name": b["name"], "commit_sha": b["commit"]["id"][:10],
+         "protected": b.get("protected", False)}
+        for b in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def create_branch(project_id: str, branch: str, ref: str) -> str:
+    """Create a new branch from an existing ref (branch/tag/SHA)."""
+    return _json(await _gl().create_branch(project_id, branch, ref))
+
+
+# ── Pipelines ─────────────────────────────────────────────────────────────────
+
+@mcp.tool()
+async def list_pipelines(project_id: str, ref: str = "", per_page: int = 20) -> str:
+    """List CI/CD pipelines. Optionally filter by ref (branch/tag)."""
+    data = await _gl().list_pipelines(project_id, ref=ref, per_page=per_page)
+    rows = [
+        {"id": p["id"], "status": p["status"], "ref": p["ref"],
+         "sha": p["sha"][:10], "created_at": p["created_at"]}
+        for p in data
+    ]
+    return _json(rows)
+
+
+@mcp.tool()
+async def get_pipeline(project_id: str, pipeline_id: int) -> str:
+    """Get details of a specific pipeline."""
+    return _json(await _gl().get_pipeline(project_id, pipeline_id))
+
+
+# ── Entry point ───────────────────────────────────────────────────────────────
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()