@mokoconsulting/mcp-mokogit

v1.12.2

Published

a month ago

MCP server for MokoGIT (Git) REST API v1 operations

0High
0Medium
0Low

mcp-mokogit

MCP server for MokoGIT REST API v1 operations -- 118 tools (canonical mokogit_* names, plus deprecated git_* aliases) for complete MokoGIT instance management from Claude Code and other MCP clients.

Background

mokogit-api-mcp is a Model Context Protocol (MCP) server that exposes 118 tools for interacting with the MokoGIT REST API v1. Tools use canonical mokogit_* names, with legacy git_* names retained as deprecated aliases (see Tools). It supports multiple named connections, allowing you to manage several MokoGIT instances from a single server. Authentication uses MokoGIT's native Authorization: token header format.

Installation

Prerequisites

Node.js >= 20.0.0
A MokoGIT instance with API access
A MokoGIT access token (Settings > Applications > Generate Token)

Build from Source

git clone https://git.mokoconsulting.tech/MokoConsulting/mcp-mokogit.git
cd mcp-mokogit
npm install
npm run build

Configuration

Create ~/.mcp_mokogit.json:

{
  "defaultConnection": "moko",
  "connections": {
    "moko": {
      "baseUrl": "https://git.mokoconsulting.tech",
      "token": "your-git-access-token",
      "insecure": false
    }
  }
}

Config Fields

| Field | Type | Required | Description | |-------|------|----------|-------------| | baseUrl | string | Yes | Base URL of your MokoGIT instance | | token | string | Yes | MokoGIT API access token | | insecure | boolean | No | Skip TLS verification (self-signed certs) |

Override the config path with the MOKOGIT_MCP_CONFIG environment variable.

Multi-Connection Example

{
  "defaultConnection": "moko",
  "connections": {
    "moko": {
      "baseUrl": "https://git.mokoconsulting.tech",
      "token": "token-for-moko-git"
    },
    "github-mirror": {
      "baseUrl": "https://git.example.com",
      "token": "token-for-mirror"
    }
  }
}

Usage

Claude Code Registration

Add to your Claude Code MCP config (~/.claude/claude_desktop_config.json or project-level .mcp.json):

{
  "mcpServers": {
    "git-moko": {
      "command": "node",
      "args": ["/path/to/mcp-mokogit/dist/index.js"]
    }
  }
}

Multi-Connection Usage in Claude Code

When using multiple connections, pass the connection parameter to any tool:

Use mokogit_repo_get with connection "github-mirror" to get owner/repo details.

If connection is omitted, the defaultConnection is used.

Tools

Tool naming: `mokogit_` (canonical) vs `git_` (deprecated aliases)

As part of the Git → MokoGIT brand normalization, the canonical name for every tool is mokogit_* (e.g. mokogit_repo_get, mokogit_pull_merge, mokogit_metadata_update). For a transition window the legacy git_* names are still registered as deprecated aliases that call the same handlers, so existing agent configs and skills keep working — but new integrations should use the mokogit_* names.

The tables below list each tool by its legacy git_* name for continuity; the canonical name is the same string with the git_ prefix replaced by mokogit_.

Legacy aliases are enabled by default. To expose only the canonical mokogit_* names (halving the tool count), set the environment variable MOKOGIT_MCP_LEGACY_ALIASES to a falsy value (0, false, off, or no). While enabled, both names are registered, so the exposed tool count is roughly double the 118 logical tools during the deprecation window.

User / Auth (3 tools)

| Tool | Description | |------|-------------| | git_me | Get the authenticated user info | | git_user_orgs | List organizations the authenticated user belongs to | | git_user_repos | List repositories owned by the authenticated user |

Repositories (8 tools)

| Tool | Description | |------|-------------| | git_repo_get | Get repository details | | git_repo_create | Create a new repository | | git_repo_delete | Delete a repository | | git_repo_edit | Edit repository settings | | git_repo_fork | Fork a repository | | git_repo_search | Search repositories | | git_org_repos | List repositories in an organization | | git_list_connections | List configured MokoGIT connections |

File Contents (5 tools)

| Tool | Description | |------|-------------| | git_file_get | Get file contents from a repository | | git_dir_get | Get directory contents (file listing) from a repository | | git_file_create_or_update | Create or update a file in a repository | | git_file_delete | Delete a file from a repository | | git_tree_get | Get the git tree for a repository (recursive file listing) |

Branches (4 tools)

| Tool | Description | |------|-------------| | git_branches_list | List branches in a repository | | git_branch_get | Get a specific branch | | git_branch_create | Create a new branch | | git_branch_delete | Delete a branch |

Commits (2 tools)

| Tool | Description | |------|-------------| | git_commits_list | List commits in a repository | | git_commit_get | Get a specific commit |

Issues (7 tools)

| Tool | Description | |------|-------------| | git_issues_list | List issues in a repository | | git_issue_get | Get a single issue by number | | git_issue_create | Create a new issue | | git_issue_update | Update an issue | | git_issue_comments_list | List comments on an issue | | git_issue_comment_create | Add a comment to an issue | | git_issue_search | Search issues across all repositories |

Labels (2 tools)

| Tool | Description | |------|-------------| | git_labels_list | List labels in a repository | | git_label_create | Create a label |

Milestones (2 tools)

| Tool | Description | |------|-------------| | git_milestones_list | List milestones in a repository | | git_milestone_create | Create a milestone |

Pull Requests (6 tools)

| Tool | Description | |------|-------------| | git_pulls_list | List pull requests | | git_pull_get | Get a single pull request | | git_pull_create | Create a pull request | | git_pull_merge | Merge a pull request | | git_pull_files | List files changed in a pull request | | git_pull_review_create | Create a pull request review |

Releases (5 tools)

| Tool | Description | |------|-------------| | git_releases_list | List releases | | git_release_get | Get a single release by ID | | git_release_latest | Get the latest release | | git_release_create | Create a new release | | git_release_delete | Delete a release |

Tags (3 tools)

| Tool | Description | |------|-------------| | git_tags_list | List tags | | git_tag_create | Create a tag | | git_tag_delete | Delete a tag |

Actions (2 tools)

| Tool | Description | |------|-------------| | git_actions_runs_list | List workflow runs for a repository | | git_actions_run_get | Get a specific workflow run |

Organizations (3 tools)

| Tool | Description | |------|-------------| | git_org_get | Get organization details | | git_org_teams_list | List teams in an organization | | git_org_members_list | List members of an organization |

Users (2 tools)

| Tool | Description | |------|-------------| | git_user_get | Get a user profile | | git_users_search | Search users |

Webhooks (2 tools)

| Tool | Description | |------|-------------| | git_webhooks_list | List webhooks for a repository | | git_webhook_create | Create a webhook |

Wiki (7 tools)

| Tool | Description | |------|-------------| | git_wiki_pages_list | List wiki pages | | git_wiki_page_get | Get a wiki page | | git_wiki_page_create | Create a new wiki page | | git_wiki_page_edit | Edit an existing wiki page (omitting title preserves the page's current title) | | git_wiki_page_delete | Delete a wiki page | | git_wiki_page_revisions | List revision history for a wiki page | | git_wiki_search | Search wiki page titles and content |

Notifications (2 tools)

| Tool | Description | |------|-------------| | git_notifications_list | List notifications for the authenticated user | | git_notifications_read | Mark all notifications as read |

Generic (2 tools)

| Tool | Description | |------|-------------| | git_api_request | Make a raw API request to any MokoGIT v1 endpoint | | git_list_connections | List configured MokoGIT connections |

Contributing

See CONTRIBUTING.md for development guidelines.

License

Revision History

| Version | Date | Description | |---------|------|-------------| | 0.0.1 | 2026-05-07 | Initial release with 61 tools | | 1.4.3 | 2026-06-23 | Fix wiki create endpoint, add wiki search + revisions tools (111 total) | | 1.6.0 | 2026-07-19 | Drop retired git_manifest_* tools, add git_platforms_list for the platform registry |