quickcall-integrations 0.1.8__tar.gz → 0.3.0__tar.gz

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.
Files changed (42) hide show
  1. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/.gitignore +3 -0
  2. quickcall_integrations-0.3.0/.pre-commit-config.yaml +18 -0
  3. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/PKG-INFO +71 -61
  4. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/README.md +70 -60
  5. quickcall_integrations-0.3.0/mcp_server/api_clients/github_client.py +751 -0
  6. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/auth/__init__.py +8 -0
  7. quickcall_integrations-0.3.0/mcp_server/auth/credentials.py +586 -0
  8. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/tools/auth_tools.py +194 -27
  9. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/tools/git_tools.py +174 -0
  10. quickcall_integrations-0.3.0/mcp_server/tools/github_tools.py +709 -0
  11. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/plugins/quickcall/.claude-plugin/plugin.json +2 -2
  12. quickcall_integrations-0.3.0/plugins/quickcall/commands/appraisal.md +128 -0
  13. quickcall_integrations-0.3.0/plugins/quickcall/commands/connect-github-pat.md +43 -0
  14. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/pyproject.toml +3 -1
  15. quickcall_integrations-0.3.0/tests/appraisal/__init__.py +1 -0
  16. quickcall_integrations-0.3.0/tests/appraisal/setup_test_data.py +461 -0
  17. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/uv.lock +131 -1
  18. quickcall_integrations-0.1.8/mcp_server/api_clients/github_client.py +0 -462
  19. quickcall_integrations-0.1.8/mcp_server/auth/credentials.py +0 -278
  20. quickcall_integrations-0.1.8/mcp_server/tools/github_tools.py +0 -338
  21. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/.claude-plugin/marketplace.json +0 -0
  22. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/.github/workflows/publish-pypi.yml +0 -0
  23. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/Dockerfile +0 -0
  24. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/assets/logo.png +0 -0
  25. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/__init__.py +0 -0
  26. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/api_clients/__init__.py +0 -0
  27. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/api_clients/slack_client.py +0 -0
  28. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/auth/device_flow.py +0 -0
  29. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/resources/__init__.py +0 -0
  30. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/resources/slack_resources.py +0 -0
  31. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/server.py +0 -0
  32. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/tools/__init__.py +0 -0
  33. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/tools/slack_tools.py +0 -0
  34. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/mcp_server/tools/utility_tools.py +0 -0
  35. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/plugins/quickcall/commands/connect.md +0 -0
  36. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/plugins/quickcall/commands/slack-summary.md +0 -0
  37. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/plugins/quickcall/commands/status.md +0 -0
  38. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/plugins/quickcall/commands/updates.md +0 -0
  39. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/requirements.txt +0 -0
  40. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/tests/README.md +0 -0
  41. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/tests/test_integrations.py +0 -0
  42. {quickcall_integrations-0.1.8 → quickcall_integrations-0.3.0}/tests/test_tools.py +0 -0
@@ -9,6 +9,8 @@ secrets/
9
9
  *.env
10
10
  *.env.*
11
11
  *.pem
12
+ .quickcall.env
13
+ quickcall.env
12
14
  mcp-inspector-config.json
13
15
 
14
16
  # Byte-compiled / optimized / DLL files
@@ -105,3 +107,4 @@ dmypy.json
105
107
  # OS
106
108
  .DS_Store
107
109
  Thumbs.db
110
+ .githooks/
@@ -0,0 +1,18 @@
1
+ repos:
2
+ - repo: https://github.com/pre-commit/pre-commit-hooks
3
+ rev: v5.0.0
4
+ hooks:
5
+ - id: trailing-whitespace
6
+ - id: end-of-file-fixer
7
+ - id: check-yaml
8
+ - id: check-json
9
+ - id: check-added-large-files
10
+ args: ['--maxkb=1000']
11
+ - id: check-merge-conflict
12
+
13
+ - repo: https://github.com/astral-sh/ruff-pre-commit
14
+ rev: v0.9.9
15
+ hooks:
16
+ - id: ruff
17
+ args: [--fix, --exit-non-zero-on-fix]
18
+ - id: ruff-format
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: quickcall-integrations
3
- Version: 0.1.8
3
+ Version: 0.3.0
4
4
  Summary: MCP server with developer integrations for Claude Code and Cursor
5
5
  Requires-Python: >=3.10
6
6
  Requires-Dist: fastmcp>=2.13.0
@@ -26,8 +26,9 @@ Description-Content-Type: text/markdown
26
26
  </p>
27
27
 
28
28
  <p align="center">
29
- <a href="#integrations">Integrations</a> |
30
29
  <a href="#install">Install</a> |
30
+ <a href="#capabilities">Capabilities</a> |
31
+ <a href="#integrations">Integrations</a> |
31
32
  <a href="#authentication">Authentication</a> |
32
33
  <a href="#commands">Commands</a> |
33
34
  <a href="#troubleshooting">Troubleshooting</a>
@@ -35,6 +36,42 @@ Description-Content-Type: text/markdown
35
36
 
36
37
  ---
37
38
 
39
+ ## Install
40
+
41
+ ### Claude Code
42
+
43
+ **In your terminal:**
44
+ ```bash
45
+ claude mcp add quickcall -- uvx quickcall-integrations
46
+ ```
47
+
48
+ **In Claude Code:**
49
+ ```
50
+ /plugin marketplace add quickcall-dev/quickcall-integrations
51
+ ```
52
+ ```
53
+ /plugin enable quickcall
54
+ ```
55
+
56
+ **Restart Claude Code**, then verify with `/mcp` and `/plugin list`.
57
+
58
+ ### Cursor / Other IDEs
59
+
60
+ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
61
+
62
+ ```json
63
+ {
64
+ "mcpServers": {
65
+ "quickcall": {
66
+ "command": "uvx",
67
+ "args": ["quickcall-integrations"]
68
+ }
69
+ }
70
+ }
71
+ ```
72
+
73
+ > Works with any IDE that supports MCP servers.
74
+
38
75
  ## Capabilities
39
76
 
40
77
  - **Get standup updates** from git history (commits, diffs, stats)
@@ -99,56 +136,10 @@ Description-Content-Type: text/markdown
99
136
 
100
137
  </details>
101
138
 
102
- ## Install
103
-
104
- ### Claude Code
105
-
106
- ```
107
- /plugin marketplace add quickcall-dev/quickcall-integrations
108
- /plugin install quickcall@quickcall-integrations
109
- ```
110
-
111
- <details>
112
- <summary>MCP only (without plugin)</summary>
113
-
114
- ```bash
115
- claude mcp add quickcall -- uvx quickcall-integrations
116
- ```
117
- </details>
118
-
119
- <details>
120
- <summary>Update to latest version</summary>
121
-
122
- ```
123
- /plugin marketplace update quickcall-integrations
124
- /plugin uninstall quickcall
125
- /plugin install quickcall@quickcall-integrations
126
- ```
127
-
128
- After updating, restart Claude Code or open a new terminal.
129
- </details>
130
-
131
- ### Cursor
132
-
133
- Add to your Cursor MCP config (`~/.cursor/mcp.json` for global, or `.cursor/mcp.json` for project):
134
-
135
- ```json
136
- {
137
- "mcpServers": {
138
- "quickcall": {
139
- "command": "uvx",
140
- "args": ["quickcall-integrations"]
141
- }
142
- }
143
- }
144
- ```
145
-
146
- Then restart Cursor.
147
-
148
- > Also works with [Antigravity](https://antigravity.dev) and any other IDE that supports MCP servers.
149
-
150
139
  ## Authentication
151
140
 
141
+ ### Option 1: QuickCall (Recommended)
142
+
152
143
  To use GitHub and Slack integrations, connect your QuickCall account:
153
144
 
154
145
  ```
@@ -162,6 +153,30 @@ This will guide you through:
162
153
 
163
154
  Credentials are stored locally in `~/.quickcall/credentials.json`.
164
155
 
156
+ ### Option 2: GitHub PAT (For Enterprise Users)
157
+
158
+ If your organization can't install the QuickCall GitHub App (common at enterprises with strict app policies), you can use a Personal Access Token instead:
159
+
160
+ **Environment Variable:**
161
+ ```bash
162
+ export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
163
+ ```
164
+
165
+ **Or config file** (create `.quickcall.env` in your project root or home directory):
166
+ ```bash
167
+ # .quickcall.env
168
+ GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
169
+ GITHUB_USERNAME=your-username # Optional: for better UX
170
+ ```
171
+
172
+ **Create a PAT at:** https://github.com/settings/tokens
173
+
174
+ **Required scopes:**
175
+ - `repo` - Full access to private repositories
176
+ - `public_repo` - Access to public repositories only (if you don't need private repos)
177
+
178
+ **Note:** PAT mode provides access to GitHub tools only. For Slack integration, use QuickCall authentication.
179
+
165
180
  ## Commands
166
181
 
167
182
  ### Claude Code
@@ -214,27 +229,22 @@ What did I work on this week? Send summary to #standup
214
229
 
215
230
  ## Troubleshooting
216
231
 
217
- ### Plugin Not Updating?
232
+ ### Clean Reinstall
218
233
 
219
- If new commands don't appear after updating, clear the cache:
234
+ If commands don't appear or aren't updating:
220
235
 
221
236
  ```bash
237
+ # Remove everything
222
238
  rm -rf ~/.claude/plugins/cache/quickcall-integrations
223
239
  rm -rf ~/.claude/plugins/marketplaces/quickcall-integrations
240
+ claude mcp remove quickcall
224
241
  ```
225
242
 
226
- Then restart Claude Code and reinstall:
227
-
228
- ```
229
- /plugin marketplace add quickcall-dev/quickcall-integrations
230
- /plugin install quickcall@quickcall-integrations
231
- ```
243
+ Then follow the [install steps](#claude-code) again.
232
244
 
233
245
  ### Commands Not Showing?
234
246
 
235
- Type `/quickcall:` - you should see `connect`, `status`, `updates`.
236
-
237
- If only `updates` shows, run the cleanup above and reinstall.
247
+ Type `/quickcall:` - you should see `connect`, `status`, `updates`. If not, do a clean reinstall above.
238
248
 
239
249
  ---
240
250
 
@@ -14,8 +14,9 @@
14
14
  </p>
15
15
 
16
16
  <p align="center">
17
- <a href="#integrations">Integrations</a> |
18
17
  <a href="#install">Install</a> |
18
+ <a href="#capabilities">Capabilities</a> |
19
+ <a href="#integrations">Integrations</a> |
19
20
  <a href="#authentication">Authentication</a> |
20
21
  <a href="#commands">Commands</a> |
21
22
  <a href="#troubleshooting">Troubleshooting</a>
@@ -23,6 +24,42 @@
23
24
 
24
25
  ---
25
26
 
27
+ ## Install
28
+
29
+ ### Claude Code
30
+
31
+ **In your terminal:**
32
+ ```bash
33
+ claude mcp add quickcall -- uvx quickcall-integrations
34
+ ```
35
+
36
+ **In Claude Code:**
37
+ ```
38
+ /plugin marketplace add quickcall-dev/quickcall-integrations
39
+ ```
40
+ ```
41
+ /plugin enable quickcall
42
+ ```
43
+
44
+ **Restart Claude Code**, then verify with `/mcp` and `/plugin list`.
45
+
46
+ ### Cursor / Other IDEs
47
+
48
+ Add to MCP config (`~/.cursor/mcp.json` or `.cursor/mcp.json`):
49
+
50
+ ```json
51
+ {
52
+ "mcpServers": {
53
+ "quickcall": {
54
+ "command": "uvx",
55
+ "args": ["quickcall-integrations"]
56
+ }
57
+ }
58
+ }
59
+ ```
60
+
61
+ > Works with any IDE that supports MCP servers.
62
+
26
63
  ## Capabilities
27
64
 
28
65
  - **Get standup updates** from git history (commits, diffs, stats)
@@ -87,56 +124,10 @@
87
124
 
88
125
  </details>
89
126
 
90
- ## Install
91
-
92
- ### Claude Code
93
-
94
- ```
95
- /plugin marketplace add quickcall-dev/quickcall-integrations
96
- /plugin install quickcall@quickcall-integrations
97
- ```
98
-
99
- <details>
100
- <summary>MCP only (without plugin)</summary>
101
-
102
- ```bash
103
- claude mcp add quickcall -- uvx quickcall-integrations
104
- ```
105
- </details>
106
-
107
- <details>
108
- <summary>Update to latest version</summary>
109
-
110
- ```
111
- /plugin marketplace update quickcall-integrations
112
- /plugin uninstall quickcall
113
- /plugin install quickcall@quickcall-integrations
114
- ```
115
-
116
- After updating, restart Claude Code or open a new terminal.
117
- </details>
118
-
119
- ### Cursor
120
-
121
- Add to your Cursor MCP config (`~/.cursor/mcp.json` for global, or `.cursor/mcp.json` for project):
122
-
123
- ```json
124
- {
125
- "mcpServers": {
126
- "quickcall": {
127
- "command": "uvx",
128
- "args": ["quickcall-integrations"]
129
- }
130
- }
131
- }
132
- ```
133
-
134
- Then restart Cursor.
135
-
136
- > Also works with [Antigravity](https://antigravity.dev) and any other IDE that supports MCP servers.
137
-
138
127
  ## Authentication
139
128
 
129
+ ### Option 1: QuickCall (Recommended)
130
+
140
131
  To use GitHub and Slack integrations, connect your QuickCall account:
141
132
 
142
133
  ```
@@ -150,6 +141,30 @@ This will guide you through:
150
141
 
151
142
  Credentials are stored locally in `~/.quickcall/credentials.json`.
152
143
 
144
+ ### Option 2: GitHub PAT (For Enterprise Users)
145
+
146
+ If your organization can't install the QuickCall GitHub App (common at enterprises with strict app policies), you can use a Personal Access Token instead:
147
+
148
+ **Environment Variable:**
149
+ ```bash
150
+ export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
151
+ ```
152
+
153
+ **Or config file** (create `.quickcall.env` in your project root or home directory):
154
+ ```bash
155
+ # .quickcall.env
156
+ GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
157
+ GITHUB_USERNAME=your-username # Optional: for better UX
158
+ ```
159
+
160
+ **Create a PAT at:** https://github.com/settings/tokens
161
+
162
+ **Required scopes:**
163
+ - `repo` - Full access to private repositories
164
+ - `public_repo` - Access to public repositories only (if you don't need private repos)
165
+
166
+ **Note:** PAT mode provides access to GitHub tools only. For Slack integration, use QuickCall authentication.
167
+
153
168
  ## Commands
154
169
 
155
170
  ### Claude Code
@@ -202,27 +217,22 @@ What did I work on this week? Send summary to #standup
202
217
 
203
218
  ## Troubleshooting
204
219
 
205
- ### Plugin Not Updating?
220
+ ### Clean Reinstall
206
221
 
207
- If new commands don't appear after updating, clear the cache:
222
+ If commands don't appear or aren't updating:
208
223
 
209
224
  ```bash
225
+ # Remove everything
210
226
  rm -rf ~/.claude/plugins/cache/quickcall-integrations
211
227
  rm -rf ~/.claude/plugins/marketplaces/quickcall-integrations
228
+ claude mcp remove quickcall
212
229
  ```
213
230
 
214
- Then restart Claude Code and reinstall:
215
-
216
- ```
217
- /plugin marketplace add quickcall-dev/quickcall-integrations
218
- /plugin install quickcall@quickcall-integrations
219
- ```
231
+ Then follow the [install steps](#claude-code) again.
220
232
 
221
233
  ### Commands Not Showing?
222
234
 
223
- Type `/quickcall:` - you should see `connect`, `status`, `updates`.
224
-
225
- If only `updates` shows, run the cleanup above and reinstall.
235
+ Type `/quickcall:` - you should see `connect`, `status`, `updates`. If not, do a clean reinstall above.
226
236
 
227
237
  ---
228
238