github-operations

GitHub PR & Issue Management

Overview

This skill allows you to manage Pull Requests and Issues via the centralized MCP Server. For git operations (clone, pull, push, commit, branch), use the git-delegation skill instead.

Environment Variables

No environment variables needed — mcporter reads its config from the default path ./config/mcporter.json automatically.

How to Call GitHub Tools

Use mcporter CLI to call MCP Server tools:

# Method 1: key=value format (recommended for simple args)
mcporter \
  call mcp-github.<TOOL_NAME> key1=value1 key2=value2

# Method 2: JSON format with --args flag (for complex objects)
mcporter \
  call mcp-github.<TOOL_NAME> --args '{"key1":"value1","key2":"value2"}'

IMPORTANT:

• Always place --config BEFORE the call subcommand
• For JSON arguments, use the --args flag (not bare JSON string)
• Use mcp-github.<tool_name> selector format

Output

mcporter returns JSON output. Parse with jq for clean results.

Pull Request Operations

create_pull_request

Create a new Pull Request:

mcporter \
  call mcp-github.create_pull_request --args '{
    "owner": "higress-group",
    "repo": "agentteams",
    "title": "Add new feature",
    "body": "## Summary\n- Change 1\n- Change 2\n\n## Test plan\n- [ ] Test A\n- [ ] Test B",
    "head": "feature-branch",
    "base": "main"
  }'

list_pull_requests

List PRs in a repository:

mcporter \
  call mcp-github.list_pull_requests owner=higress-group repo=agentteams state=open

get_pull_request

Get details of a specific PR:

mcporter \
  call mcp-github.get_pull_request owner=higress-group repo=agentteams pull_number=1

update_pull_request

Update PR title, body, or state:

mcporter \
  call mcp-github.update_pull_request --args '{
    "owner": "higress-group",
    "repo": "agentteams",
    "pull_number": 1,
    "title": "Updated title",
    "body": "Updated description"
  }'

merge_pull_request

Merge a PR:

mcporter \
  call mcp-github.merge_pull_request owner=higress-group repo=agentteams pull_number=1 merge_method=squash

get_pull_request_files

List files changed in a PR:

mcporter \
  call mcp-github.get_pull_request_files owner=higress-group repo=agentteams pull_number=1

get_pull_request_status

Get CI status of a PR:

mcporter \
  call mcp-github.get_pull_request_status owner=higress-group repo=agentteams pull_number=1

request_reviewers

Request reviewers for a PR:

mcporter \
  call mcp-github.request_reviewers --args '{
    "owner": "higress-group",
    "repo": "agentteams",
    "pull_number": 1,
    "reviewers": ["reviewer-username"]
  }'

PR Comments & Reviews

add_issue_comment (general PR comments)

Add a general comment to a PR (PRs are also issues):

mcporter \
  call mcp-github.add_issue_comment owner=higress-group repo=agentteams issue_number=1 body="LGTM! Great work."

list_issue_comments

List comments on a PR:

mcporter \
  call mcp-github.list_issue_comments owner=higress-group repo=agentteams issue_number=1

create_pull_request_review_comment

Comment on a specific code line in a PR:

# First get the latest commit SHA from the PR
PR_DATA=$(mcporter \
  call mcp-github.get_pull_request owner=higress-group repo=agentteams pull_number=1)
COMMIT_SHA=$(echo "$PR_DATA" | jq -r '.head.sha')

# Create a review comment
mcporter \
  call mcp-github.create_pull_request_review_comment --args '{
    "owner": "higress-group",
    "repo": "agentteams",
    "pull_number": 1,
    "body": "Consider using a helper function here.",
    "commit_id": "'"$COMMIT_SHA"'",
    "path": "src/utils/helpers.ts",
    "line": 42,
    "side": "RIGHT"
  }'

get_pull_request_comments

List all review comments on a PR:

mcporter \
  call mcp-github.get_pull_request_comments owner=higress-group repo=agentteams pull_number=1

get_pull_request_reviews

List reviews on a PR:

mcporter \
  call mcp-github.get_pull_request_reviews owner=higress-group repo=agentteams pull_number=1

Issue Operations

create_issue

Create a new issue:

mcporter \
  call mcp-github.create_issue owner=higress-group repo=agentteams title="Bug report" body="Description..."

list_issues

List issues in a repository:

mcporter \
  call mcp-github.list_issues owner=higress-group repo=agentteams state=open

get_issue

Get details of a specific issue:

mcporter \
  call mcp-github.get_issue owner=higress-group repo=agentteams issue_number=1

update_issue

Update issue title, body, state, or labels:

mcporter \
  call mcp-github.update_issue --args '{
    "owner": "higress-group",
    "repo": "agentteams",
    "issue_number": 1,
    "title": "Updated title",
    "state": "closed"
  }'

add_issue_comment

Add a comment to an issue:

mcporter \
  call mcp-github.add_issue_comment owner=higress-group repo=agentteams issue_number=1 body="Comment text"

list_issue_comments

List comments on an issue:

mcporter \
  call mcp-github.list_issue_comments owner=higress-group repo=agentteams issue_number=1

Labels

list_labels

List labels in a repository:

mcporter \
  call mcp-github.list_labels owner=higress-group repo=agentteams

get_label

Get details of a label:

mcporter \
  call mcp-github.get_label owner=higress-group repo=agentteams name=bug

Search Operations

search_issues

Search issues and PRs:

mcporter \
  call mcp-github.search_issues q="is:issue is:open repo:agentscope-ai/AgentTeams"

search_code

Search code in repositories:

mcporter \
  call mcp-github.search_code q="function handleAuth repo:agentscope-ai/AgentTeams"

search_repositories

Search repositories:

mcporter \
  call mcp-github.search_repositories query="agentteams language:go"

search_users

Search users:

mcporter \
  call mcp-github.search_users q="john location:shanghai"

Utility Operations

get_me

Get current authenticated user:

mcporter \
  call mcp-github.get_me

list_notifications

List notifications:

mcporter \
  call mcp-github.list_notifications all=false

list_teams

List teams in an organization:

mcporter \
  call mcp-github.list_teams

list_team_members

List members of a team:

mcporter \
  call mcp-github.list_team_members org=higress-group team_slug=core-team

Known Issues

• create_pull_request_review: Has a template processing bug. For adding PR review comments, use:
  • General PR comment: Use add_issue_comment
  • Comment on specific code line: Use create_pull_request_review_comment

Important Notes

• Transport: The MCP Server uses HTTP transport (configured in mcporter-servers.json)
• Auth: HTTP endpoint requires Authorization header with Bearer token (auto-configured)
• Rate limits: GitHub API rate limits apply. If you get 403 responses, wait and retry
• Permissions: Your MCP access is controlled by the Manager. If you get 403 from the MCP Server, the Manager may need to re-authorize your access

Typical Workflow

1. Clone & modify → Use git-delegation skill
2. Push changes → Use git-delegation skill
3. Create PR → Use create_pull_request (this skill)
4. Review PR → Use add_issue_comment, create_pull_request_review_comment (this skill)
5. Merge PR → Use merge_pull_request (this skill)