mirror of
https://github.com/github/awesome-copilot.git
synced 2026-08-31 13:03:07 +00:00
chore: publish from main
This commit is contained in:
@@ -20,9 +20,17 @@ Manage GitHub issues using the `@modelcontextprotocol/server-github` MCP server.
|
|||||||
| `mcp__github__projects_get` | Get details of a project, field, item, or status update |
|
| `mcp__github__projects_get` | Get details of a project, field, item, or status update |
|
||||||
| `mcp__github__projects_write` | Add/update/delete project items, create status updates |
|
| `mcp__github__projects_write` | Add/update/delete project items, create status updates |
|
||||||
|
|
||||||
|
### MCP Tools (write operations)
|
||||||
|
|
||||||
|
| Tool | Purpose |
|
||||||
|
|------|---------|
|
||||||
|
| `mcp__github__issue_write` | Create or update an issue (methods: create, update). Supports title, body, type, labels, assignees, milestone, and issue fields |
|
||||||
|
| `mcp__github__add_issue_comment` | Add a comment or a reaction to an issue |
|
||||||
|
| `mcp__github__sub_issue_write` | Add, remove, or reprioritize a sub-issue |
|
||||||
|
|
||||||
### CLI / REST API (write operations)
|
### CLI / REST API (write operations)
|
||||||
|
|
||||||
The MCP server does not currently support creating, updating, or commenting on issues. Use `gh api` for these operations.
|
`gh api` performs the same writes and is the form used in the examples below. Reach for it when the MCP server is not connected, or when you need a REST field the MCP tools do not expose.
|
||||||
|
|
||||||
| Operation | Command |
|
| Operation | Command |
|
||||||
|-----------|---------|
|
|-----------|---------|
|
||||||
@@ -61,11 +69,18 @@ Add any of these flags to the `gh api` call:
|
|||||||
|
|
||||||
```
|
```
|
||||||
-f type="Bug" # Issue type (Bug, Feature, Task, Epic, etc.)
|
-f type="Bug" # Issue type (Bug, Feature, Task, Epic, etc.)
|
||||||
-f labels[]="bug" # Labels (repeat for multiple)
|
-f 'labels[]=bug' # Labels (repeat for multiple)
|
||||||
-f assignees[]="username" # Assignees (repeat for multiple)
|
-f 'assignees[]=username' # Assignees (repeat for multiple)
|
||||||
-f milestone=1 # Milestone number
|
-f milestone=1 # Milestone number
|
||||||
```
|
```
|
||||||
|
|
||||||
|
**Quote the whole `name[]=value` pair.** `[]` is a glob pattern in zsh, the default shell
|
||||||
|
on macOS, so an unquoted `-f labels[]=bug` never reaches `gh`:
|
||||||
|
|
||||||
|
```
|
||||||
|
zsh: no matches found: labels[]=bug
|
||||||
|
```
|
||||||
|
|
||||||
**Issue types** are organization-level metadata. To discover available types, use:
|
**Issue types** are organization-level metadata. To discover available types, use:
|
||||||
```bash
|
```bash
|
||||||
gh api graphql -f query='{ organization(login: "ORG") { issueTypes(first: 10) { nodes { name } } } }' --jq '.data.organization.issueTypes.nodes[].name'
|
gh api graphql -f query='{ organization(login: "ORG") { issueTypes(first: 10) { nodes { name } } } }' --jq '.data.organization.issueTypes.nodes[].name'
|
||||||
@@ -145,7 +160,7 @@ gh api repos/github/awesome-copilot/issues \
|
|||||||
-X POST \
|
-X POST \
|
||||||
-f title="Add dark mode support" \
|
-f title="Add dark mode support" \
|
||||||
-f type="Feature" \
|
-f type="Feature" \
|
||||||
-f labels[]="high-priority" \
|
-f 'labels[]=high-priority' \
|
||||||
-f body="## Summary
|
-f body="## Summary
|
||||||
Add dark mode theme option for improved user experience and accessibility.
|
Add dark mode theme option for improved user experience and accessibility.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user