{"_id":"@adamglin0/mcp-gitlab","name":"@adamglin0/mcp-gitlab","dist-tags":{"latest":"1.0.45"},"versions":{"1.0.45":{"name":"@adamglin0/mcp-gitlab","version":"1.0.45","description":"MCP server for using the GitLab API","license":"MIT","author":{"name":"zereight"},"type":"module","bin":{"mcp-gitlab":"build/index.js"},"publishConfig":{"access":"public"},"engines":{"node":">=14"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","prepare":"npm run build","watch":"tsc --watch","deploy":"npm publish --access public","generate-tools":"npx ts-node scripts/generate-tools-readme.ts"},"dependencies":{"@modelcontextprotocol/sdk":"1.8.0","form-data":"^4.0.0","@types/node-fetch":"^2.6.12","http-proxy-agent":"^7.0.2","https-proxy-agent":"^7.0.6","node-fetch":"^3.3.2","socks-proxy-agent":"^8.0.5","zod-to-json-schema":"^3.23.5"},"devDependencies":{"@types/node":"^22.13.10","typescript":"^5.8.2","zod":"^3.24.2"},"_id":"@adamglin0/mcp-gitlab@1.0.45","gitHead":"ca8e00fb215a17944d231844cda78efca2411597","_nodeVersion":"22.15.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-yAjgY+UV8aPhSFDBoMEOwOTNsgVtVAFa4cHcsMy81VK8VhNapXK7RY1CGxrz9UQqy4QmYSNaRJPTr9X6Iw84ig==","shasum":"3e1cc02a8b8a2314df309231c248ea6961180270","tarball":"https://registry.npmjs.org/@adamglin0/mcp-gitlab/-/mcp-gitlab-1.0.45.tgz","fileCount":7,"unpackedSize":156292,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGz9iYk1V8NizjlLztVnupuC7/+P9p+tO6ubVIDIXUYtAiAs6a2N7S61Wd0xwyAeY8cx7ANSD6jdfs5hmppZJS/ZVA=="}]},"_npmUser":{"name":"cntrelfp","email":"10223983lin_faping@cn.tre-inc.com"},"directories":{},"maintainers":[{"name":"cntrelfp","email":"10223983lin_faping@cn.tre-inc.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-gitlab_1.0.45_1748336147517_0.04076058840186514"},"_hasShrinkwrap":false}},"time":{"created":"2025-05-27T08:55:46.797Z","1.0.45":"2025-05-27T08:55:47.713Z","modified":"2025-05-27T08:55:51.960Z"},"maintainers":[{"name":"cntrelfp","email":"10223983lin_faping@cn.tre-inc.com"}],"description":"MCP server for using the GitLab API","author":{"name":"zereight"},"license":"MIT","readme":"# Better GitLab MCP Server\n\n## @zereight/mcp-gitlab\n\n[![smithery badge](https://smithery.ai/badge/@zereight/gitlab-mcp)](https://smithery.ai/server/@zereight/gitlab-mcp)\n\nGitLab MCP(Model Context Protocol) Server. **Includes bug fixes and improvements over the original GitLab MCP server.**\n\n<a href=\"https://glama.ai/mcp/servers/7jwbk4r6d7\"><img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/7jwbk4r6d7/badge\" alt=\"gitlab mcp MCP server\" /></a>\n\n## Usage\n\n### Using with Claude App, Cline, Roo Code, Cursor\n\nWhen using with the Claude App, you need to set up your API key and URLs directly.\n\n#### npx\n\n```json\n{\n  \"mcpServers\": {\n    \"GitLab communication server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@zereight/mcp-gitlab\"],\n      \"env\": {\n        \"GITLAB_PERSONAL_ACCESS_TOKEN\": \"your_gitlab_token\",\n        \"GITLAB_API_URL\": \"your_gitlab_api_url\",\n        \"GITLAB_READ_ONLY_MODE\": \"false\",\n        \"GITLAB_REVIEW_ONLY_MODE\": \"false\",\n        \"USE_GITLAB_WIKI\": \"true\"\n      }\n    }\n  }\n}\n```\n\n#### Docker\n\n```json\n{\n  \"mcpServers\": {\n    \"GitLab communication server\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"-e\",\n        \"GITLAB_PERSONAL_ACCESS_TOKEN\",\n        \"-e\",\n        \"GITLAB_API_URL\",\n        \"-e\",\n        \"GITLAB_READ_ONLY_MODE\",\n        \"-e\",\n        \"GITLAB_REVIEW_ONLY_MODE\",\n        \"-e\",\n        \"USE_GITLAB_WIKI\",\n        \"nkwd/gitlab-mcp\"\n      ],\n      \"env\": {\n        \"GITLAB_PERSONAL_ACCESS_TOKEN\": \"your_gitlab_token\",\n        \"GITLAB_API_URL\": \"https://gitlab.com/api/v4\", // Optional, for self-hosted GitLab\n        \"GITLAB_READ_ONLY_MODE\": \"false\",\n        \"GITLAB_REVIEW_ONLY_MODE\": \"false\",\n        \"USE_GITLAB_WIKI\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n- `GITLAB_PERSONAL_ACCESS_TOKEN`: Your GitLab personal access token.\n- `GITLAB_API_URL`: Your GitLab API URL. (Default: `https://gitlab.com/api/v4`)\n- `GITLAB_READ_ONLY_MODE`: When set to 'true', restricts the server to only expose read-only operations. Useful for enhanced security or when write access is not needed. Also useful for using with Cursor and it's 40 tool limit.\n- `GITLAB_REVIEW_ONLY_MODE`: When set to 'true', restricts the server to only expose read-only tools plus tools for adding comments and creating modification suggestions. Unlike `GITLAB_READ_ONLY_MODE`, it allows interaction with MRs through comments and suggestions.\n- `USE_GITLAB_WIKI`: When set to 'true', enables the wiki-related tools (list_wiki_pages, get_wiki_page, create_wiki_page, update_wiki_page, delete_wiki_page). By default, wiki features are disabled.\n\n## Tools 🛠️\n\n+<!-- TOOLS-START -->\n1. `create_or_update_file` - Create or update a single file in a GitLab project\n2. `search_repositories` - Search for GitLab projects\n3. `create_repository` - Create a new GitLab project\n4. `get_file_contents` - Get the contents of a file or directory from a GitLab project\n5. `push_files` - Push multiple files to a GitLab project in a single commit\n6. `create_issue` - Create a new issue in a GitLab project\n7. `create_merge_request` - Create a new merge request in a GitLab project\n8. `fork_repository` - Fork a GitLab project to your account or specified namespace\n9. `create_branch` - Create a new branch in a GitLab project\n10. `get_merge_request` - Get details of a merge request (Either mergeRequestIid or branchName must be provided)\n11. `get_merge_request_diffs` - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)\n12. `update_merge_request` - Update a merge request (Either mergeRequestIid or branchName must be provided)\n13. `create_note` - Create a new note (comment) to an issue or merge request\n14. `create_merge_request_thread` - Create a new thread on a merge request\n15. `mr_discussions` - List discussion items for a merge request\n16. `update_merge_request_note` - Modify an existing merge request thread note\n17. `create_merge_request_note` - Add a new note to an existing merge request thread\n18. `update_issue_note` - Modify an existing issue thread note\n19. `create_issue_note` - Add a new note to an existing issue thread\n20. `list_issues` - List issues in a GitLab project with filtering options\n21. `get_issue` - Get details of a specific issue in a GitLab project\n22. `update_issue` - Update an issue in a GitLab project\n23. `delete_issue` - Delete an issue from a GitLab project\n24. `list_issue_links` - List all issue links for a specific issue\n25. `list_issue_discussions` - List discussions for an issue in a GitLab project\n26. `get_issue_link` - Get a specific issue link\n27. `create_issue_link` - Create an issue link between two issues\n28. `delete_issue_link` - Delete an issue link\n29. `list_namespaces` - List all namespaces available to the current user\n30. `get_namespace` - Get details of a namespace by ID or path\n31. `verify_namespace` - Verify if a namespace path exists\n32. `get_project` - Get details of a specific project\n33. `list_projects` - List projects accessible by the current user\n34. `list_labels` - List labels for a project\n35. `get_label` - Get a single label from a project\n36. `create_label` - Create a new label in a project\n37. `update_label` - Update an existing label in a project\n38. `delete_label` - Delete a label from a project\n39. `list_group_projects` - List projects in a GitLab group with filtering options\n40. `list_wiki_pages` - List wiki pages in a GitLab project\n41. `get_wiki_page` - Get details of a specific wiki page\n42. `create_wiki_page` - Create a new wiki page in a GitLab project\n43. `update_wiki_page` - Update an existing wiki page in a GitLab project\n44. `delete_wiki_page` - Delete a wiki page from a GitLab project\n45. `get_repository_tree` - Get the repository tree for a GitLab project (list files and directories)\n46. `list_pipelines` - List pipelines in a GitLab project with filtering options\n47. `get_pipeline` - Get details of a specific pipeline in a GitLab project\n48. `list_pipeline_jobs` - List all jobs in a specific pipeline\n49. `get_pipeline_job` - Get details of a GitLab pipeline job number\n50. `get_pipeline_job_output` - Get the output/trace of a GitLab pipeline job number\n<!-- TOOLS-END -->\n","readmeFilename":"README.md","_rev":"1-d1241b7d72bcd2ec77ef707041e8e823"}