@auphansoftware/mcp-gitlab

MCP server for GitLab API with wiki pages support - Auphan Software

Installation

For Auphan Software Team Members

1. Install the package:

npm install -g @auphansoftware/mcp-gitlab

2. Add to your Claude Code settings file (.claude/settings.local.json):

{
  "mcpServers": {
    "gitlab-wiki": {
      "command": "node",
      "args": ["/path/to/global/node_modules/@auphansoftware/mcp-gitlab/build/index.js"],
      "env": {
        "GITLAB_API_URL": "https://your-gitlab-instance.com/api/v4",
        "GITLAB_PERSONAL_ACCESS_TOKEN": "your-token-here",
        "ARGON2_SALT": "defaultSaltForTesting"
      }
    }
  },
  "permissions": {
    "allow": [
      "mcp__gitlab-wiki__list_wiki_pages",
      "mcp__gitlab-wiki__get_wiki_page"
    ]
  }
}

Alternative: Local Installation

If you prefer to run from source:

1. Clone this repository to a shared location
2. Build the project:

cd /path/to/mcp-gitlab-wiki
npm install
npm run build

3. Configure Claude Code to point to the local build:

{
  "mcpServers": {
    "gitlab-wiki": {
      "command": "node",
      "args": ["/path/to/mcp-gitlab-wiki/build/index.js"],
      "env": {
        "GITLAB_API_URL": "https://your-gitlab-instance.com/api/v4",
        "GITLAB_PERSONAL_ACCESS_TOKEN": "your-token-here",
        "ARGON2_SALT": "defaultSaltForTesting"
      }
    }
  }
}

Setup

1. Get GitLab Personal Access Token

1. Go to your GitLab instance user settings: https://your-gitlab-instance/-/user_settings/personal_access_tokens
2. Create a new token with api scope
3. Copy the token (starts with glpat-)

2. Configure Claude Code

Replace the placeholder values in the settings with your actual configuration.

Important: On Windows, the global npm modules path might be:

• C:/Users/[username]/AppData/Roaming/npm/node_modules/@auphansoftware/mcp-gitlab/build/index.js
• Or find it with: npm list -g @auphansoftware/mcp-gitlab

Available Tools

• mcp__gitlab-wiki__list_wiki_pages - List all wiki pages in a project
• mcp__gitlab-wiki__get_wiki_page - Get content of a specific wiki page

Usage Examples

Once configured, you can ask Claude Code:

• "Show me all wiki pages in the manual.wiki project"
• "Get the content of the home page from the wiki"
• "List wiki pages for project techs/manual.wiki"

Environment Variables

• GITLAB_API_URL: Your GitLab API URL (e.g., https://your-gitlab-instance.com/api/v4)
• GITLAB_PERSONAL_ACCESS_TOKEN: Your GitLab personal access token
• ARGON2_SALT: Salt for encryption (can use default value)
• GITLAB_DISABLED_TOOLS: Comma-separated list of tool names to disable (optional)

Tool Filtering

You can disable specific tools by setting the GITLAB_DISABLED_TOOLS environment variable:

export GITLAB_DISABLED_TOOLS="upload_markdown,download_attachment,create_wiki_page"

This will hide the specified tools from the context window, reducing clutter when you don't need certain functionality.

Development

Building from Source

git clone [this-repository]
cd mcp-gitlab-wiki
npm install
npm run build

Testing

npm run test

Support

For issues or questions, contact the Auphan Software development team.

Based On

This project extends zereight/gitlab-mcp with specific enhancements for Auphan Software's GitLab wiki integration.