quickcall-integrations 0.1.3__py3-none-any.whl → 0.1.5__py3-none-any.whl

mcp_server/tools/github_tools.py

@@ -0,0 +1,338 @@
+"""
+GitHub Tools - Pull requests and commits via GitHub API.
+
+These tools require authentication via QuickCall.
+Connect using connect_quickcall tool first.
+"""
+
+from typing import Optional
+import logging
+
+from fastmcp import FastMCP
+from fastmcp.exceptions import ToolError
+from pydantic import Field
+
+from mcp_server.auth import get_credential_store, is_authenticated
+from mcp_server.api_clients.github_client import GitHubClient
+
+logger = logging.getLogger(__name__)
+
+
+def _get_client() -> GitHubClient:
+    """Get the GitHub client, raising error if not configured."""
+    store = get_credential_store()
+
+    if not store.is_authenticated():
+        raise ToolError(
+            "Not connected to QuickCall. "
+            "Run connect_quickcall to authenticate and enable GitHub tools."
+        )
+
+    # Fetch fresh credentials from API
+    creds = store.get_api_credentials()
+
+    if not creds or not creds.github_connected:
+        raise ToolError(
+            "GitHub not connected. "
+            "Connect GitHub at quickcall.dev/assistant to enable GitHub tools."
+        )
+
+    if not creds.github_token:
+        raise ToolError(
+            "Could not fetch GitHub token. "
+            "Try reconnecting GitHub at quickcall.dev/assistant."
+        )
+
+    # Create client with fresh token and installation ID
+    return GitHubClient(
+        token=creds.github_token,
+        default_owner=creds.github_username,
+        installation_id=creds.github_installation_id,
+    )
+
+
+def create_github_tools(mcp: FastMCP) -> None:
+    """Add GitHub tools to the MCP server."""
+
+    @mcp.tool(tags={"github", "repos"})
+    def list_repos(
+        limit: int = Field(
+            default=20,
+            description="Maximum number of repositories to return (default: 20)",
+        ),
+    ) -> dict:
+        """
+        List GitHub repositories accessible to the authenticated user.
+
+        Returns repositories sorted by last updated.
+        Requires QuickCall authentication with GitHub connected.
+        """
+        try:
+            client = _get_client()
+            repos = client.list_repos(limit=limit)
+
+            return {
+                "count": len(repos),
+                "repos": [repo.model_dump() for repo in repos],
+            }
+        except ToolError:
+            raise
+        except Exception as e:
+            raise ToolError(f"Failed to list repositories: {str(e)}")
+
+    @mcp.tool(tags={"github", "prs"})
+    def list_prs(
+        owner: Optional[str] = Field(
+            default=None,
+            description="Repository owner (username or org). Uses your GitHub username if not specified.",
+        ),
+        repo: Optional[str] = Field(
+            default=None,
+            description="Repository name. Required.",
+        ),
+        state: str = Field(
+            default="open",
+            description="PR state: 'open', 'closed', or 'all' (default: 'open')",
+        ),
+        limit: int = Field(
+            default=20,
+            description="Maximum number of PRs to return (default: 20)",
+        ),
+    ) -> dict:
+        """
+        List pull requests for a GitHub repository.
+
+        Returns PRs sorted by last updated.
+        Requires QuickCall authentication with GitHub connected.
+        """
+        try:
+            client = _get_client()
+            prs = client.list_prs(owner=owner, repo=repo, state=state, limit=limit)
+
+            return {
+                "count": len(prs),
+                "prs": [pr.model_dump() for pr in prs],
+            }
+        except ToolError:
+            raise
+        except ValueError as e:
+            raise ToolError(
+                f"Repository not specified: {str(e)}. "
+                f"Please provide both owner and repo parameters."
+            )
+        except Exception as e:
+            raise ToolError(f"Failed to list pull requests: {str(e)}")
+
+    @mcp.tool(tags={"github", "prs"})
+    def get_pr(
+        pr_number: int = Field(..., description="Pull request number", gt=0),
+        owner: Optional[str] = Field(
+            default=None,
+            description="Repository owner. Uses your GitHub username if not specified.",
+        ),
+        repo: Optional[str] = Field(
+            default=None,
+            description="Repository name. Required.",
+        ),
+    ) -> dict:
+        """
+        Get detailed information about a specific pull request.
+
+        Includes title, description, status, files changed, and review status.
+        Requires QuickCall authentication with GitHub connected.
+        """
+        try:
+            client = _get_client()
+            pr = client.get_pr(pr_number, owner=owner, repo=repo)
+
+            if not pr:
+                raise ToolError(f"Pull request #{pr_number} not found")
+
+            return {"pr": pr.model_dump()}
+        except ToolError:
+            raise
+        except ValueError as e:
+            raise ToolError(
+                f"Repository not specified: {str(e)}. "
+                f"Please provide both owner and repo parameters."
+            )
+        except Exception as e:
+            raise ToolError(f"Failed to get pull request #{pr_number}: {str(e)}")
+
+    @mcp.tool(tags={"github", "commits"})
+    def list_commits(
+        owner: Optional[str] = Field(
+            default=None,
+            description="Repository owner. Uses your GitHub username if not specified.",
+        ),
+        repo: Optional[str] = Field(
+            default=None,
+            description="Repository name. Required.",
+        ),
+        branch: Optional[str] = Field(
+            default=None,
+            description="Branch name to list commits from. Defaults to default branch.",
+        ),
+        author: Optional[str] = Field(
+            default=None,
+            description="Filter by author username",
+        ),
+        since: Optional[str] = Field(
+            default=None,
+            description="ISO datetime - only commits after this date (e.g., '2024-01-01T00:00:00Z')",
+        ),
+        limit: int = Field(
+            default=20,
+            description="Maximum number of commits to return (default: 20)",
+        ),
+    ) -> dict:
+        """
+        List commits for a GitHub repository.
+
+        Returns commits sorted by date (newest first).
+        Requires QuickCall authentication with GitHub connected.
+        """
+        try:
+            client = _get_client()
+            commits = client.list_commits(
+                owner=owner,
+                repo=repo,
+                sha=branch,
+                author=author,
+                since=since,
+                limit=limit,
+            )
+
+            return {
+                "count": len(commits),
+                "commits": [commit.model_dump() for commit in commits],
+            }
+        except ToolError:
+            raise
+        except ValueError as e:
+            raise ToolError(
+                f"Repository not specified: {str(e)}. "
+                f"Please provide both owner and repo parameters."
+            )
+        except Exception as e:
+            raise ToolError(f"Failed to list commits: {str(e)}")
+
+    @mcp.tool(tags={"github", "commits"})
+    def get_commit(
+        sha: str = Field(..., description="Commit SHA (full or abbreviated)"),
+        owner: Optional[str] = Field(
+            default=None,
+            description="Repository owner. Uses your GitHub username if not specified.",
+        ),
+        repo: Optional[str] = Field(
+            default=None,
+            description="Repository name. Required.",
+        ),
+    ) -> dict:
+        """
+        Get detailed information about a specific commit.
+
+        Includes commit message, author, stats, and file changes.
+        Requires QuickCall authentication with GitHub connected.
+        """
+        try:
+            client = _get_client()
+            commit = client.get_commit(sha, owner=owner, repo=repo)
+
+            if not commit:
+                raise ToolError(f"Commit {sha} not found")
+
+            return {"commit": commit}
+        except ToolError:
+            raise
+        except ValueError as e:
+            raise ToolError(
+                f"Repository not specified: {str(e)}. "
+                f"Please provide both owner and repo parameters."
+            )
+        except Exception as e:
+            raise ToolError(f"Failed to get commit {sha}: {str(e)}")
+
+    @mcp.tool(tags={"github", "branches"})
+    def list_branches(
+        owner: Optional[str] = Field(
+            default=None,
+            description="Repository owner. Uses your GitHub username if not specified.",
+        ),
+        repo: Optional[str] = Field(
+            default=None,
+            description="Repository name. Required.",
+        ),
+        limit: int = Field(
+            default=30,
+            description="Maximum number of branches to return (default: 30)",
+        ),
+    ) -> dict:
+        """
+        List branches for a GitHub repository.
+
+        Returns branch names with their latest commit SHA and protection status.
+        Requires QuickCall authentication with GitHub connected.
+        """
+        try:
+            client = _get_client()
+            branches = client.list_branches(owner=owner, repo=repo, limit=limit)
+
+            return {
+                "count": len(branches),
+                "branches": branches,
+            }
+        except ToolError:
+            raise
+        except ValueError as e:
+            raise ToolError(
+                f"Repository not specified: {str(e)}. "
+                f"Please provide both owner and repo parameters."
+            )
+        except Exception as e:
+            raise ToolError(f"Failed to list branches: {str(e)}")
+
+    @mcp.tool(tags={"github", "status"})
+    def check_github_connection() -> dict:
+        """
+        Check if GitHub is connected and working.
+
+        Tests the GitHub connection by fetching your account info.
+        Use this to verify your GitHub integration is working.
+        """
+        store = get_credential_store()
+
+        if not store.is_authenticated():
+            return {
+                "connected": False,
+                "error": "Not connected to QuickCall. Run connect_quickcall first.",
+            }
+
+        creds = store.get_api_credentials()
+
+        if not creds:
+            return {
+                "connected": False,
+                "error": "Could not fetch credentials from QuickCall.",
+            }
+
+        if not creds.github_connected:
+            return {
+                "connected": False,
+                "error": "GitHub not connected. Connect at quickcall.dev/assistant.",
+            }
+
+        try:
+            client = _get_client()
+            username = client.get_authenticated_user()
+
+            return {
+                "connected": True,
+                "username": username,
+                "installation_id": creds.github_installation_id,
+            }
+        except Exception as e:
+            return {
+                "connected": False,
+                "error": str(e),
+            }

mcp_server/tools/slack_tools.py

@@ -0,0 +1,203 @@
+"""
+Slack Tools - Messaging and channel operations.
+
+These tools require authentication via QuickCall.
+Connect using connect_quickcall tool first.
+"""
+
+from typing import Optional
+import logging
+
+from fastmcp import FastMCP
+from fastmcp.exceptions import ToolError
+from pydantic import Field
+
+from mcp_server.auth import get_credential_store
+from mcp_server.api_clients.slack_client import SlackClient, SlackAPIError
+
+logger = logging.getLogger(__name__)
+
+
+def _get_client() -> SlackClient:
+    """Get the Slack client, raising error if not configured."""
+    store = get_credential_store()
+
+    if not store.is_authenticated():
+        raise ToolError(
+            "Not connected to QuickCall. "
+            "Run connect_quickcall to authenticate and enable Slack tools."
+        )
+
+    # Fetch fresh credentials from API
+    creds = store.get_api_credentials()
+
+    if not creds or not creds.slack_connected:
+        raise ToolError(
+            "Slack not connected. "
+            "Connect Slack at quickcall.dev/assistant to enable Slack tools."
+        )
+
+    if not creds.slack_bot_token:
+        raise ToolError(
+            "Could not fetch Slack token. "
+            "Try reconnecting Slack at quickcall.dev/assistant."
+        )
+
+    # Create client with fresh token
+    return SlackClient(bot_token=creds.slack_bot_token)
+
+
+def create_slack_tools(mcp: FastMCP) -> None:
+    """Add Slack tools to the MCP server."""
+
+    @mcp.tool(tags={"slack", "channels"})
+    def list_slack_channels(
+        include_private: bool = Field(
+            default=True,
+            description="Include private channels the bot has access to (default: true)",
+        ),
+        limit: int = Field(
+            default=100,
+            description="Maximum number of channels to return (default: 100)",
+        ),
+    ) -> dict:
+        """
+        List Slack channels the bot has access to.
+
+        Returns channel names, IDs, and membership status.
+        Requires QuickCall authentication with Slack connected.
+        """
+        try:
+            client = _get_client()
+            channels = client.list_channels(
+                include_private=include_private, limit=limit
+            )
+
+            return {
+                "count": len(channels),
+                "channels": [ch.model_dump() for ch in channels],
+            }
+        except ToolError:
+            raise
+        except SlackAPIError as e:
+            raise ToolError(str(e))
+        except Exception as e:
+            raise ToolError(f"Failed to list Slack channels: {str(e)}")
+
+    @mcp.tool(tags={"slack", "messaging"})
+    def send_slack_message(
+        message: str = Field(
+            ...,
+            description="Message text to send. Supports Slack mrkdwn formatting.",
+        ),
+        channel: Optional[str] = Field(
+            default=None,
+            description="Channel name (with or without #) or channel ID. Required.",
+        ),
+    ) -> dict:
+        """
+        Send a message to a Slack channel.
+
+        The bot must be a member of the channel to send messages.
+        Requires QuickCall authentication with Slack connected.
+
+        Message formatting (mrkdwn):
+        - *bold* for bold text
+        - _italic_ for italic text
+        - `code` for inline code
+        - ```code block``` for code blocks
+        - <https://example.com|link text> for links
+        """
+        try:
+            client = _get_client()
+            result = client.send_message(text=message, channel=channel)
+
+            return {
+                "success": result.ok,
+                "channel": result.channel,
+                "message_ts": result.ts,
+            }
+        except ToolError:
+            raise
+        except SlackAPIError as e:
+            raise ToolError(str(e))
+        except ValueError as e:
+            raise ToolError(str(e))
+        except Exception as e:
+            raise ToolError(f"Failed to send Slack message: {str(e)}")
+
+    @mcp.tool(tags={"slack", "users"})
+    def list_slack_users(
+        limit: int = Field(
+            default=100,
+            description="Maximum number of users to return (default: 100)",
+        ),
+        include_bots: bool = Field(
+            default=False,
+            description="Include bot users in the list (default: false)",
+        ),
+    ) -> dict:
+        """
+        List users in the Slack workspace.
+
+        Returns user names, display names, and email addresses.
+        Requires QuickCall authentication with Slack connected.
+        """
+        try:
+            client = _get_client()
+            users = client.list_users(limit=limit, include_bots=include_bots)
+
+            return {
+                "count": len(users),
+                "users": [user.model_dump() for user in users],
+            }
+        except ToolError:
+            raise
+        except SlackAPIError as e:
+            raise ToolError(str(e))
+        except Exception as e:
+            raise ToolError(f"Failed to list Slack users: {str(e)}")
+
+    @mcp.tool(tags={"slack", "status"})
+    def check_slack_connection() -> dict:
+        """
+        Check if Slack is connected and working.
+
+        Tests the Slack bot token by calling auth.test.
+        Use this to verify your Slack integration is working.
+        """
+        store = get_credential_store()
+
+        if not store.is_authenticated():
+            return {
+                "connected": False,
+                "error": "Not connected to QuickCall. Run connect_quickcall first.",
+            }
+
+        creds = store.get_api_credentials()
+
+        if not creds:
+            return {
+                "connected": False,
+                "error": "Could not fetch credentials from QuickCall.",
+            }
+
+        if not creds.slack_connected:
+            return {
+                "connected": False,
+                "error": "Slack not connected. Connect at quickcall.dev/assistant.",
+            }
+
+        try:
+            client = _get_client()
+            status = client.health_check()
+
+            if status.get("connected"):
+                status["team_name"] = creds.slack_team_name
+                status["team_id"] = creds.slack_team_id
+            return status
+        except Exception as e:
+            return {
+                "connected": False,
+                "error": str(e),
+            }

quickcall_integrations-0.1.5.dist-info/METADATA

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: quickcall-integrations
+Version: 0.1.5
+Summary: MCP server with developer integrations for Claude Code and Cursor
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=2.13.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: pygithub>=2.8.1
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/logo.png" alt="QuickCall" width="400">
+</p>
+
+<h3 align="center">Eliminate interruptions for developers</h3>
+
+<p align="center">
+  <em>Ask about your work, get instant answers. No more context switching.</em>
+</p>
+
+<p align="center">
+  <a href="https://quickcall.dev"><img src="https://img.shields.io/badge/Web-quickcall.dev-000000?logo=googlechrome&logoColor=white" alt="Web"></a>
+  <a href="https://discord.gg/DtnMxuE35v"><img src="https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
+</p>
+
+<p align="center">
+  <a href="#integrations">Integrations</a> |
+  <a href="#install">Install</a> |
+  <a href="#authentication">Authentication</a> |
+  <a href="#commands">Commands</a>
+</p>
+
+---
+
+## Integrations
+
+- **Git** - commits, diffs, code changes (always available)
+- **GitHub** - repos, PRs, commits, branches (requires QuickCall account)
+- **Slack** - send messages, list channels/users (requires QuickCall account)
+
+## Install
+
+### Claude Code
+
+```
+/plugin marketplace add quickcall-dev/quickcall-integrations
+/plugin install quickcall@quickcall-integrations
+```
+
+<details>
+<summary>MCP only (without plugin)</summary>
+
+```bash
+claude mcp add quickcall -- uvx quickcall-integrations
+```
+</details>
+
+<details>
+<summary>Update to latest version</summary>
+
+```
+/plugin marketplace update quickcall-integrations
+/plugin uninstall quickcall
+/plugin install quickcall@quickcall-integrations
+```
+
+After updating, restart Claude Code or open a new terminal.
+</details>
+
+### Cursor
+
+Add to your Cursor MCP config (`~/.cursor/mcp.json` for global, or `.cursor/mcp.json` for project):
+
+```json
+{
+  "mcpServers": {
+    "quickcall": {
+      "command": "uvx",
+      "args": ["quickcall-integrations"]
+    }
+  }
+}
+```
+
+Then restart Cursor.
+
+> Also works with [Antigravity](https://antigravity.dev) and any other IDE that supports MCP servers.
+
+## Authentication
+
+To use GitHub and Slack integrations, connect your QuickCall account:
+
+```
+/quickcall:connect
+```
+
+This will guide you through:
+1. Sign in with Google
+2. Install GitHub App to your org/account
+3. Connect Slack workspace
+
+Credentials are stored locally in `~/.quickcall/credentials.json`.
+
+## Commands
+
+### Claude Code
+
+| Command | Description |
+|---------|-------------|
+| `/quickcall:connect` | Connect QuickCall, GitHub, and Slack |
+| `/quickcall:status` | Show connection status |
+| `/quickcall:updates` | Get git updates (default: 1 day) |
+| `/quickcall:updates 7d` | Get updates for last 7 days |
+
+### Cursor / Other IDEs
+
+Ask the AI naturally:
+- "What did I work on today?"
+- "Show me my open PRs"
+- "List my GitHub repos"
+- "Send a message to #general on Slack"
+
+---
+
+<p align="center">
+  Built with ❤️ by <a href="https://quickcall.dev">QuickCall</a>
+</p>

quickcall_integrations-0.1.5.dist-info/RECORD

@@ -0,0 +1,18 @@
+mcp_server/__init__.py,sha256=wAVZ0eHQoGovs-66UH9-kRkcv37bprVEUeinyUFS_KI,98
+mcp_server/server.py,sha256=9Ojv5DoQrCeyC6lDD3keh9BuLyNKB6mb6FUslP6z0O8,2839
+mcp_server/api_clients/__init__.py,sha256=kOG5_sxIVpAx_tvf1nq_P0QCkqojAVidRE-wenLS-Wc,207
+mcp_server/api_clients/github_client.py,sha256=Wj326ImYI11eFyItP5HQ4TD7aQ4nC6WAR12ZbneBiAQ,13569
+mcp_server/api_clients/slack_client.py,sha256=Tby3vkPo-yN38Egb6Cj7MQk6Ul3DV4BOp5nVWScR4cw,10424
+mcp_server/auth/__init__.py,sha256=YQpDPH5itIaBuEm0AtwNCHxTX4L5dLutTximVamsItw,552
+mcp_server/auth/credentials.py,sha256=OCPs_4DcQ1zHEBgkcPDNCHVFFO36Xe6_QBx_5Jn2xgk,9379
+mcp_server/auth/device_flow.py,sha256=NXNWHzd-CA4dlhEVCgUhwfpe9TpMKpLSJuyFCh70xKs,8371
+mcp_server/tools/__init__.py,sha256=vIR2ujAaTXm2DgpTsVNz3brI4G34p-Jeg44Qe0uvWc0,405
+mcp_server/tools/auth_tools.py,sha256=wuhEucxeTT08DWT1TCxoYrEa6Jy2MIpOlXBxtCeYEXQ,14586
+mcp_server/tools/git_tools.py,sha256=5cZfngkP1wHNYUvGtLFcMjS7bhrFzxAC_TPz0h3CUB0,7691
+mcp_server/tools/github_tools.py,sha256=GomR88SByAbdi4VHk1vaUNp29hwWEIY6cX1t9QoMDOU,10972
+mcp_server/tools/slack_tools.py,sha256=uXCxnzLfdi5LaM3ayVS5JT7F3MAnI6C0vB7jW0tZfjY,6303
+mcp_server/tools/utility_tools.py,sha256=1WiOpJivu6Ug9OLajm77lzsmFfBPgWHs8e1hNCEX_Aw,3359
+quickcall_integrations-0.1.5.dist-info/METADATA,sha256=MNjKo7oYIeo4QJSqxpnoshDFzRvJFJ4LP36HCxnq2yI,3133
+quickcall_integrations-0.1.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+quickcall_integrations-0.1.5.dist-info/entry_points.txt,sha256=kkcunmJUzncYvQ1rOR35V2LPm2HcFTKzdI2l3n7NwiM,66
+quickcall_integrations-0.1.5.dist-info/RECORD,,

mcp_server/config.py

@@ -1,10 +0,0 @@
-"""
-Configuration for QuickCall Integrations MCP Server.
-"""
-
-
-class Config:
-    """Configuration class for MCP server."""
-
-    SERVER_NAME: str = "QuickCall Integrations (OSS)"
-    SERVER_VERSION: str = "1.0.0"