@paretools/github 0.7.0 → 0.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +78 -0
- package/package.json +2 -2
package/README.md
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# @paretools/github
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@paretools/github)
|
|
4
|
+
[](https://github.com/Dave-London/Pare/blob/main/LICENSE)
|
|
5
|
+
|
|
6
|
+
**Structured, token-efficient GitHub operations for AI agents.** Wraps the [GitHub CLI](https://cli.github.com/) (`gh`) with typed JSON output.
|
|
7
|
+
|
|
8
|
+
Part of the [Pare](https://github.com/Dave-London/Pare) suite of MCP servers.
|
|
9
|
+
|
|
10
|
+
## Tools (8)
|
|
11
|
+
|
|
12
|
+
| Tool | Description |
|
|
13
|
+
| -------------- | -------------------------------------------------------- |
|
|
14
|
+
| `pr-view` | View PR details with checks, review decision, diff stats |
|
|
15
|
+
| `pr-list` | List PRs with state/author/label filters |
|
|
16
|
+
| `pr-create` | Create a pull request with title, body, base/head |
|
|
17
|
+
| `issue-view` | View issue details with labels, assignees, body |
|
|
18
|
+
| `issue-list` | List issues with state/label/assignee filters |
|
|
19
|
+
| `issue-create` | Create an issue with title, body, labels |
|
|
20
|
+
| `run-view` | View workflow run details with job statuses |
|
|
21
|
+
| `run-list` | List workflow runs with branch/status filters |
|
|
22
|
+
|
|
23
|
+
## Quick Start
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npx -y @paretools/github
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Add to your MCP client config:
|
|
30
|
+
|
|
31
|
+
```json
|
|
32
|
+
{
|
|
33
|
+
"mcpServers": {
|
|
34
|
+
"pare-github": {
|
|
35
|
+
"command": "npx",
|
|
36
|
+
"args": ["-y", "@paretools/github"]
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Example
|
|
43
|
+
|
|
44
|
+
**`pr-view` output:**
|
|
45
|
+
|
|
46
|
+
```json
|
|
47
|
+
{
|
|
48
|
+
"number": 42,
|
|
49
|
+
"state": "OPEN",
|
|
50
|
+
"title": "Add search functionality",
|
|
51
|
+
"mergeable": "MERGEABLE",
|
|
52
|
+
"reviewDecision": "APPROVED",
|
|
53
|
+
"checks": [{ "name": "CI", "status": "COMPLETED", "conclusion": "SUCCESS" }],
|
|
54
|
+
"url": "https://github.com/owner/repo/pull/42",
|
|
55
|
+
"headBranch": "feat/search",
|
|
56
|
+
"baseBranch": "main",
|
|
57
|
+
"additions": 150,
|
|
58
|
+
"deletions": 20,
|
|
59
|
+
"changedFiles": 5
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
## Prerequisites
|
|
64
|
+
|
|
65
|
+
- [GitHub CLI](https://cli.github.com/) (`gh`) installed and authenticated (`gh auth login`)
|
|
66
|
+
|
|
67
|
+
## Compatible Clients
|
|
68
|
+
|
|
69
|
+
Works with any MCP-compatible client: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Claude Desktop](https://claude.ai/download), [Cursor](https://cursor.com), [Windsurf](https://codeium.com/windsurf), [VS Code / GitHub Copilot](https://code.visualstudio.com), [Cline](https://github.com/cline/cline), [Roo Code](https://roocode.com), [Zed](https://zed.dev), [Continue.dev](https://continue.dev), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [OpenAI Codex](https://openai.com/index/codex/)
|
|
70
|
+
|
|
71
|
+
## Links
|
|
72
|
+
|
|
73
|
+
- [Pare monorepo](https://github.com/Dave-London/Pare)
|
|
74
|
+
- [MCP protocol](https://modelcontextprotocol.io)
|
|
75
|
+
|
|
76
|
+
## License
|
|
77
|
+
|
|
78
|
+
[MIT](https://github.com/Dave-London/Pare/blob/main/LICENSE)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@paretools/github",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.1",
|
|
4
4
|
"mcpName": "io.github.Dave-London/github",
|
|
5
5
|
"description": "MCP server for GitHub operations (PRs, issues, actions) with structured, token-efficient output",
|
|
6
6
|
"license": "MIT",
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
"dependencies": {
|
|
52
52
|
"@modelcontextprotocol/sdk": "^1.26.0",
|
|
53
53
|
"zod": "^4.3.6",
|
|
54
|
-
"@paretools/shared": "0.
|
|
54
|
+
"@paretools/shared": "0.8.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|
|
57
57
|
"@types/node": "^25.2.3",
|