quickcall-integrations 0.1.6__tar.gz → 0.1.7__tar.gz

{quickcall_integrations-0.1.6 → quickcall_integrations-0.1.7}/.gitignore

@@ -1,4 +1,8 @@
 internal-docs/
+
+# Local MCP config (for dev testing - not committed)
+.mcp.json
+
 # Secrets and environment
 secrets/
 *.env

{quickcall_integrations-0.1.6 → quickcall_integrations-0.1.7}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: quickcall-integrations
-Version: 0.1.6
+Version: 0.1.7
 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
+Requires-Dist: rapidfuzz>=3.0.0
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -34,11 +35,67 @@ Description-Content-Type: text/markdown
 
 ---
 
+## Capabilities
+
+- **Get standup updates** from git history (commits, diffs, stats)
+- **List PRs, commits, branches** from GitHub repos
+- **Send messages to Slack** channels
+- **Check connection status** for all integrations
+
 ## 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)
+| Integration | Features | Auth Required |
+|-------------|----------|---------------|
+| **Git** | Commits, diffs, standup summaries | No |
+| **GitHub** | Repos, PRs, commits, branches | Yes |
+| **Slack** | Read/send messages, threads, channels | Yes |
+
+<details>
+<summary><strong>Available Tools (22)</strong></summary>
+
+### Git
+| Tool | Description |
+|------|-------------|
+| `get_updates` | Get git commits, diff stats, and uncommitted changes |
+
+### GitHub
+| Tool | Description |
+|------|-------------|
+| `list_repos` | List accessible repositories |
+| `list_prs` | List pull requests (open/closed/all) |
+| `get_pr` | Get PR details (title, description, files changed) |
+| `list_commits` | List commits with optional filters |
+| `get_commit` | Get commit details (message, stats, files) |
+| `list_branches` | List repository branches |
+| `check_github_connection` | Verify GitHub connection |
+
+### Slack
+| Tool | Description |
+|------|-------------|
+| `list_slack_channels` | List channels bot has access to |
+| `send_slack_message` | Send message to a channel |
+| `read_slack_messages` | Read messages from a channel (with date filter) |
+| `read_slack_thread` | Read replies in a thread |
+| `list_slack_users` | List workspace users |
+| `check_slack_connection` | Verify Slack connection |
+
+### Auth
+| Tool | Description |
+|------|-------------|
+| `connect_quickcall` | Start device flow authentication |
+| `check_quickcall_status` | Check connection status |
+| `disconnect_quickcall` | Remove local credentials |
+| `connect_github` | Install GitHub App |
+| `connect_slack` | Authorize Slack App |
+
+### Utility
+| Tool | Description |
+|------|-------------|
+| `get_current_datetime` | Get current UTC datetime |
+| `calculate_date_range` | Calculate date range for queries |
+| `calculate_date_offset` | Add/subtract time from a date |
+
+</details>
 
 ## Install
 
@@ -116,11 +173,39 @@ Credentials are stored locally in `~/.quickcall/credentials.json`.
 
 ### 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"
+Ask the AI naturally - see examples below.
+
+## Example Prompts
+
+### Git
+```
+What did I work on today?
+Give me a standup summary for the last 3 days
+What changes are uncommitted?
+```
+
+### GitHub
+```
+List my repos
+Show open PRs on [repo-name]
+What commits were made this week?
+Get details of PR #123
+List branches on [repo-name]
+```
+
+### Slack
+```
+Send "Build completed" to #deployments
+What messages were posted in #general today?
+Show me the thread replies for that message
+List channels I have access to
+```
+
+### Combined
+```
+List open PRs on [repo] and send titles to #updates channel
+What did I work on this week? Send summary to #standup
+```
 
 ## Troubleshooting
 

{quickcall_integrations-0.1.6 → quickcall_integrations-0.1.7}/README.md

@@ -23,11 +23,67 @@
 
 ---
 
+## Capabilities
+
+- **Get standup updates** from git history (commits, diffs, stats)
+- **List PRs, commits, branches** from GitHub repos
+- **Send messages to Slack** channels
+- **Check connection status** for all integrations
+
 ## 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)
+| Integration | Features | Auth Required |
+|-------------|----------|---------------|
+| **Git** | Commits, diffs, standup summaries | No |
+| **GitHub** | Repos, PRs, commits, branches | Yes |
+| **Slack** | Read/send messages, threads, channels | Yes |
+
+<details>
+<summary><strong>Available Tools (22)</strong></summary>
+
+### Git
+| Tool | Description |
+|------|-------------|
+| `get_updates` | Get git commits, diff stats, and uncommitted changes |
+
+### GitHub
+| Tool | Description |
+|------|-------------|
+| `list_repos` | List accessible repositories |
+| `list_prs` | List pull requests (open/closed/all) |
+| `get_pr` | Get PR details (title, description, files changed) |
+| `list_commits` | List commits with optional filters |
+| `get_commit` | Get commit details (message, stats, files) |
+| `list_branches` | List repository branches |
+| `check_github_connection` | Verify GitHub connection |
+
+### Slack
+| Tool | Description |
+|------|-------------|
+| `list_slack_channels` | List channels bot has access to |
+| `send_slack_message` | Send message to a channel |
+| `read_slack_messages` | Read messages from a channel (with date filter) |
+| `read_slack_thread` | Read replies in a thread |
+| `list_slack_users` | List workspace users |
+| `check_slack_connection` | Verify Slack connection |
+
+### Auth
+| Tool | Description |
+|------|-------------|
+| `connect_quickcall` | Start device flow authentication |
+| `check_quickcall_status` | Check connection status |
+| `disconnect_quickcall` | Remove local credentials |
+| `connect_github` | Install GitHub App |
+| `connect_slack` | Authorize Slack App |
+
+### Utility
+| Tool | Description |
+|------|-------------|
+| `get_current_datetime` | Get current UTC datetime |
+| `calculate_date_range` | Calculate date range for queries |
+| `calculate_date_offset` | Add/subtract time from a date |
+
+</details>
 
 ## Install
 
@@ -105,11 +161,39 @@ Credentials are stored locally in `~/.quickcall/credentials.json`.
 
 ### 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"
+Ask the AI naturally - see examples below.
+
+## Example Prompts
+
+### Git
+```
+What did I work on today?
+Give me a standup summary for the last 3 days
+What changes are uncommitted?
+```
+
+### GitHub
+```
+List my repos
+Show open PRs on [repo-name]
+What commits were made this week?
+Get details of PR #123
+List branches on [repo-name]
+```
+
+### Slack
+```
+Send "Build completed" to #deployments
+What messages were posted in #general today?
+Show me the thread replies for that message
+List channels I have access to
+```
+
+### Combined
+```
+List open PRs on [repo] and send titles to #updates channel
+What did I work on this week? Send summary to #standup
+```
 
 ## Troubleshooting
 

{quickcall_integrations-0.1.6 → quickcall_integrations-0.1.7}/mcp_server/__init__.py

@@ -3,4 +3,4 @@ MCP Server for QuickCall
 GitHub integration tools for AI assistant
 """
 
-__version__ = "0.3.4"
+__version__ = "0.1.7"

{quickcall_integrations-0.1.6 → quickcall_integrations-0.1.7}/mcp_server/api_clients/github_client.py

@@ -127,14 +127,36 @@ class GitHubClient:
     def health_check(self) -> bool:
         """Check if GitHub API is accessible with the token."""
         try:
-            self.gh.get_user().login
-            return True
+            # Use installation/repositories endpoint - works with GitHub App tokens
+            with httpx.Client() as client:
+                response = client.get(
+                    "https://api.github.com/installation/repositories",
+                    headers={
+                        "Authorization": f"Bearer {self.token}",
+                        "Accept": "application/vnd.github+json",
+                        "X-GitHub-Api-Version": "2022-11-28",
+                    },
+                    params={"per_page": 1},
+                )
+                return response.status_code == 200
         except Exception:
             return False
 
     def get_authenticated_user(self) -> str:
-        """Get the username of the authenticated user."""
-        return self.gh.get_user().login
+        """
+        Get the GitHub username associated with this installation.
+
+        Note: GitHub App installation tokens can't access /user endpoint.
+        We return the installation owner instead.
+        """
+        # Try to get from first repo's owner
+        try:
+            repos = self.list_repos(limit=1)
+            if repos:
+                return repos[0].owner.login
+        except Exception:
+            pass
+        return "GitHub App"  # Fallback
 
     def close(self):
         """Close GitHub API client."""

{quickcall_integrations-0.1.6 → quickcall_integrations-0.1.7}/mcp_server/api_clients/slack_client.py

@@ -10,6 +10,7 @@ from typing import List, Optional, Dict, Any
 
 import httpx
 from pydantic import BaseModel
+from rapidfuzz import fuzz, process
 
 logger = logging.getLogger(__name__)
 
@@ -51,6 +52,18 @@ class SlackMessage(BaseModel):
     message: Optional[Dict[str, Any]] = None
 
 
+class SlackChannelMessage(BaseModel):
+    """Represents a message from channel history."""
+
+    ts: str  # Message timestamp (used as ID)
+    user: Optional[str] = None
+    user_name: Optional[str] = None
+    text: str
+    thread_ts: Optional[str] = None
+    reply_count: int = 0
+    has_thread: bool = False
+
+
 # ============================================================================
 # Slack Client
 # ============================================================================
@@ -62,6 +75,16 @@ class SlackClient:
 
     Provides simplified interface for Slack operations.
     Uses bot token authentication.
+
+    Note on Caching:
+        This client caches channel list and user mappings to reduce API calls.
+        Cache is per-instance and does NOT expire automatically.
+        New channels/users won't appear until:
+        - MCP server restarts (new session)
+        - New SlackClient instance is created
+
+        TODO: Add TTL-based cache invalidation if this becomes an issue.
+        See internal-docs/issues/007-slack-api-caching.md
     """
 
     BASE_URL = "https://slack.com/api"
@@ -80,6 +103,9 @@ class SlackClient:
             "Authorization": f"Bearer {bot_token}",
             "Content-Type": "application/json",
         }
+        # Caches (per-instance, cleared on new client)
+        self._channel_cache: Optional[List["SlackChannel"]] = None
+        self._user_cache: Optional[Dict[str, str]] = None
 
     async def _request(
         self,
@@ -161,7 +187,7 @@ class SlackClient:
     # ========================================================================
 
     def list_channels(
-        self, include_private: bool = True, limit: int = 200
+        self, include_private: bool = True, limit: int = 200, use_cache: bool = True
     ) -> List[SlackChannel]:
         """
         List Slack channels the bot has access to.
@@ -169,18 +195,30 @@ class SlackClient:
         Args:
             include_private: Whether to include private channels
             limit: Maximum channels to return
+            use_cache: Use cached results if available (default: True)
 
         Returns:
             List of channels
         """
+        # Return cached if available
+        if use_cache and self._channel_cache is not None:
+            return (
+                self._channel_cache[:limit]
+                if limit < len(self._channel_cache)
+                else self._channel_cache
+            )
+
         types = (
             "public_channel,private_channel" if include_private else "public_channel"
         )
 
+        # Always fetch 200 to ensure we get all channels for caching
+        fetch_limit = 200
+
         data = self._request_sync(
             "GET",
             "conversations.list",
-            params={"types": types, "limit": limit, "exclude_archived": True},
+            params={"types": types, "limit": fetch_limit, "exclude_archived": True},
         )
 
         channels = []
@@ -196,11 +234,13 @@ class SlackClient:
                 )
             )
 
-        return channels
+        # Cache the full result
+        self._channel_cache = channels
+        return channels[:limit] if limit < len(channels) else channels
 
     def _resolve_channel(self, channel: Optional[str] = None) -> str:
         """
-        Resolve channel name to channel ID.
+        Resolve channel name to channel ID with fuzzy matching.
 
         Args:
             channel: Channel name (with or without #) or channel ID
@@ -213,8 +253,8 @@ class SlackClient:
         if not channel:
             raise ValueError("No channel specified and no default channel configured")
 
-        # If it's already an ID (starts with C), return as-is
-        if channel.startswith("C"):
+        # If it's already an ID (starts with C or G for private), return as-is
+        if channel.startswith("C") or channel.startswith("G"):
             return channel
 
         # Strip # prefix if present
@@ -222,9 +262,27 @@ class SlackClient:
 
         # Look up channel by name
         channels = self.list_channels()
-        for ch in channels:
-            if ch.name.lower() == channel_name:
-                return ch.id
+        channel_names = {ch.name.lower(): ch for ch in channels}
+
+        # First try exact match
+        if channel_name in channel_names:
+            return channel_names[channel_name].id
+
+        # Use rapidfuzz for fuzzy matching
+        # token_sort_ratio handles word reordering (e.g., "dev no sleep" = "no sleep dev")
+        match = process.extractOne(
+            channel_name,
+            list(channel_names.keys()),
+            scorer=fuzz.token_sort_ratio,
+            score_cutoff=70,  # Minimum 70% match
+        )
+
+        if match:
+            matched_name, score, _ = match
+            logger.info(
+                f"Fuzzy matched '{channel}' to '{matched_name}' (score: {score})"
+            )
+            return channel_names[matched_name].id
 
         raise ValueError(f"Channel '{channel}' not found or bot is not a member")
 
@@ -304,6 +362,128 @@ class SlackClient:
             message=data.get("message"),
         )
 
+    # ========================================================================
+    # Message History
+    # ========================================================================
+
+    def get_channel_messages(
+        self,
+        channel: str,
+        oldest: Optional[str] = None,
+        latest: Optional[str] = None,
+        limit: int = 100,
+    ) -> List[SlackChannelMessage]:
+        """
+        Get messages from a channel.
+
+        Args:
+            channel: Channel name or ID
+            oldest: Unix timestamp - only messages after this time
+            latest: Unix timestamp - only messages before this time
+            limit: Maximum messages to return (default 100)
+
+        Returns:
+            List of messages (newest first)
+        """
+        channel_id = self._resolve_channel(channel)
+
+        params = {
+            "channel": channel_id,
+            "limit": limit,
+        }
+
+        if oldest:
+            params["oldest"] = oldest
+        if latest:
+            params["latest"] = latest
+
+        data = self._request_sync("GET", "conversations.history", params=params)
+
+        # Get user info for resolving names
+        user_map = self._get_user_map()
+
+        messages = []
+        for msg in data.get("messages", []):
+            # Skip non-message types (joins, leaves, etc.)
+            if msg.get("subtype") in ["channel_join", "channel_leave", "bot_add"]:
+                continue
+
+            user_id = msg.get("user")
+            messages.append(
+                SlackChannelMessage(
+                    ts=msg.get("ts", ""),
+                    user=user_id,
+                    user_name=user_map.get(user_id, user_id),
+                    text=msg.get("text", ""),
+                    thread_ts=msg.get("thread_ts"),
+                    reply_count=msg.get("reply_count", 0),
+                    has_thread=msg.get("reply_count", 0) > 0,
+                )
+            )
+
+        return messages
+
+    def get_thread_replies(
+        self,
+        channel: str,
+        thread_ts: str,
+        limit: int = 100,
+    ) -> List[SlackChannelMessage]:
+        """
+        Get replies in a thread.
+
+        Args:
+            channel: Channel name or ID
+            thread_ts: Thread parent message timestamp
+            limit: Maximum replies to return
+
+        Returns:
+            List of replies (includes parent message first)
+        """
+        channel_id = self._resolve_channel(channel)
+
+        params = {
+            "channel": channel_id,
+            "ts": thread_ts,
+            "limit": limit,
+        }
+
+        data = self._request_sync("GET", "conversations.replies", params=params)
+
+        user_map = self._get_user_map()
+
+        messages = []
+        for msg in data.get("messages", []):
+            user_id = msg.get("user")
+            messages.append(
+                SlackChannelMessage(
+                    ts=msg.get("ts", ""),
+                    user=user_id,
+                    user_name=user_map.get(user_id, user_id),
+                    text=msg.get("text", ""),
+                    thread_ts=msg.get("thread_ts"),
+                    reply_count=msg.get("reply_count", 0),
+                    has_thread=False,
+                )
+            )
+
+        return messages
+
+    def _get_user_map(self) -> Dict[str, str]:
+        """Get a mapping of user IDs to display names (cached)."""
+        # Return cached if available
+        if self._user_cache is not None:
+            return self._user_cache
+
+        try:
+            users = self.list_users(limit=500, include_bots=True)
+            self._user_cache = {
+                u.id: u.display_name or u.real_name or u.name for u in users
+            }
+            return self._user_cache
+        except Exception:
+            return {}
+
     # ========================================================================
     # User Operations
     # ========================================================================

quickcall_integrations-0.1.7/mcp_server/resources/__init__.py

@@ -0,0 +1 @@
+"""MCP Resources for QuickCall."""

quickcall_integrations-0.1.7/mcp_server/resources/slack_resources.py

@@ -0,0 +1,50 @@
+"""
+Slack MCP Resources - Exposes Slack data for Claude's context.
+
+Resources are automatically available in Claude's context when connected.
+"""
+
+import logging
+from fastmcp import FastMCP
+
+from mcp_server.tools.slack_tools import _get_client
+from mcp_server.auth import get_credential_store
+
+logger = logging.getLogger(__name__)
+
+
+def create_slack_resources(mcp: FastMCP) -> None:
+    """Add Slack resources to the MCP server."""
+
+    @mcp.resource("slack://channels")
+    def get_slack_channels() -> str:
+        """
+        List of Slack channels the bot has access to.
+
+        Use these channel names when reading/sending messages.
+        """
+        store = get_credential_store()
+
+        if not store.is_authenticated():
+            return "Slack not connected. Run connect_quickcall first."
+
+        creds = store.get_api_credentials()
+        if not creds or not creds.slack_connected or not creds.slack_bot_token:
+            return "Slack not connected. Connect at quickcall.dev/assistant."
+
+        try:
+            # Use shared cached client
+            client = _get_client()
+            channels = client.list_channels(include_private=True, limit=200)
+
+            # Format as readable list
+            lines = ["Available Slack Channels:", ""]
+            for ch in channels:
+                status = "member" if ch.is_member else "not member"
+                privacy = "private" if ch.is_private else "public"
+                lines.append(f"- #{ch.name} ({privacy}, {status})")
+
+            return "\n".join(lines)
+        except Exception as e:
+            logger.error(f"Failed to fetch Slack channels: {e}")
+            return f"Error fetching channels: {str(e)}"

{quickcall_integrations-0.1.6 → quickcall_integrations-0.1.7}/mcp_server/server.py

@@ -23,6 +23,7 @@ from mcp_server.tools.utility_tools import create_utility_tools
 from mcp_server.tools.github_tools import create_github_tools
 from mcp_server.tools.slack_tools import create_slack_tools
 from mcp_server.tools.auth_tools import create_auth_tools
+from mcp_server.resources.slack_resources import create_slack_resources
 
 # Configure logging
 logging.basicConfig(
@@ -54,6 +55,9 @@ def create_server() -> FastMCP:
     create_github_tools(mcp)
     create_slack_tools(mcp)
 
+    # Register resources (available in Claude's context)
+    create_slack_resources(mcp)
+
     # Log current status
     if is_authenticated:
         logger.info("QuickCall: authenticated")