@chinchillaenterprises/mcp-slack 3.0.1

package/README.md

@@ -0,0 +1,168 @@
+# MCP Slacker V3
+
+A powerful multi-account Model Context Protocol (MCP) server for Slack that enables seamless workspace switching and persistent credential storage.
+
+## Features
+
+- 🔄 **Multi-Account Support**: Switch between multiple Slack workspaces at runtime
+- 🔐 **Secure Credential Storage**: Uses native OS keychains (macOS Keychain, Windows Credential Manager, Linux Secret Service)
+- ⚡ **Fast Performance**: <200ms startup time for 10+ workspaces
+- 🛡️ **Graceful Fallback**: Continues working even if keychain access fails
+- 🔍 **Comprehensive Slack Tools**: 30+ tools for messages, channels, users, files, and more
+
+## Installation
+
+### Using Claude Desktop
+
+```bash
+claude mcp add mcp-slacker-v3 @chinchillaenterprises/mcp-slacker-v3 --env DEFAULT_BOT_TOKEN=xoxb-YOUR-BOT-TOKEN DEFAULT_USER_TOKEN=xoxp-YOUR-USER-TOKEN DEFAULT_TEAM_ID=YOUR-TEAM-ID DEFAULT_ACCOUNT_NAME="Your Workspace Name"
+```
+
+### Using Claude Code
+
+```bash
+claude mcp add mcp-slacker-v3 @chinchillaenterprises/mcp-slacker-v3 --scope project --env DEFAULT_BOT_TOKEN=xoxb-YOUR-BOT-TOKEN DEFAULT_USER_TOKEN=xoxp-YOUR-USER-TOKEN DEFAULT_TEAM_ID=YOUR-TEAM-ID DEFAULT_ACCOUNT_NAME="Your Workspace Name"
+```
+
+### Manual Installation
+
+```bash
+npm install -g @chinchillaenterprises/mcp-slacker-v3
+```
+
+## Configuration
+
+### Environment Variables
+
+For the default workspace:
+- `DEFAULT_BOT_TOKEN`: Slack bot token (xoxb-...)
+- `DEFAULT_USER_TOKEN`: Slack user token (xoxp-...)
+- `DEFAULT_TEAM_ID`: Slack team/workspace ID
+- `DEFAULT_ACCOUNT_NAME`: Display name for the workspace
+
+## Usage
+
+### Account Management
+
+The V3 architecture introduces powerful account management capabilities:
+
+- **list_accounts**: View all configured workspaces
+- **switch_account**: Change active workspace at runtime
+- **add_account**: Add new workspace credentials
+- **remove_account**: Remove workspace from configuration
+- **update_account**: Update existing workspace credentials
+
+### Core Slack Tools
+
+#### Messaging
+- `slack_send_message`: Send messages to channels
+- `slack_send_formatted_message`: Send rich Block Kit messages
+- `slack_edit_message`: Edit existing messages
+- `slack_delete_message`: Delete messages
+- `slack_schedule_message`: Schedule messages for later
+- `slack_forward_message`: Forward messages between channels
+
+#### Channels & History
+- `slack_list_channels`: List accessible channels
+- `slack_get_channel_history`: Get recent messages
+- `slack_get_thread_replies`: Get thread conversations
+
+#### Search
+- `slack_search_messages`: Search across workspace
+- `slack_search_by_user`: Find messages from specific users
+- `slack_search_by_date_range`: Search within date ranges
+- `slack_search_files`: Search for shared files
+
+#### Users & Teams
+- `slack_list_users`: List workspace members
+- `slack_get_user_by_name`: Find users by name
+- `slack_get_user_info`: Get detailed user information
+- `slack_get_user_status`: Check user status
+- `slack_get_user_profile`: Get full profile details
+
+#### Reactions & Pins
+- `slack_add_reaction`: Add emoji reactions
+- `slack_bulk_react_messages`: React to multiple messages
+- `slack_pin_message`: Pin important messages
+- `slack_unpin_message`: Unpin messages
+
+#### Productivity
+- `slack_create_reminder`: Set reminders
+- `slack_list_reminders`: View active reminders
+- `slack_get_workspace_stats`: Get workspace analytics
+
+## Advanced Features
+
+### Persistent Storage
+
+V3 automatically persists workspace credentials to your OS keychain:
+- **macOS**: Keychain Access
+- **Windows**: Credential Manager  
+- **Linux**: Secret Service API
+
+### Graceful Degradation
+
+If keychain access fails (e.g., in containers), the server continues working with in-memory storage and logs a warning.
+
+### Performance Optimizations
+
+- Lazy loading of workspace configurations
+- Efficient caching of API responses
+- Minimal startup overhead
+
+## Architecture
+
+MCP Slacker V3 implements the Account Manager Tools Pattern:
+
+```
+┌─────────────┐     ┌──────────────┐     ┌─────────────┐
+│   Claude    │────▶│ MCP Server   │────▶│   Slack     │
+│   Desktop   │     │              │     │ Workspaces  │
+└─────────────┘     └──────────────┘     └─────────────┘
+                            │
+                            ▼
+                    ┌──────────────┐
+                    │ OS Keychain  │
+                    │   Storage    │
+                    └──────────────┘
+```
+
+## Troubleshooting
+
+### "Secure storage unavailable"
+This warning appears when keychain access is denied or unavailable. The server will continue working with temporary storage.
+
+### Missing channels or users
+Ensure your bot token has the necessary OAuth scopes:
+- `channels:read`
+- `chat:write`
+- `users:read`
+- `files:read`
+
+### Performance issues
+- Check network connectivity to Slack
+- Verify token permissions
+- Review workspace size (very large workspaces may need pagination)
+
+## Development
+
+### Building from source
+
+```bash
+git clone https://github.com/ChinchillaEnterprises/ChillMCP.git
+cd ChillMCP/mcp-slacker-v3
+npm install
+npm run build
+```
+
+### Contributing
+
+Issues and pull requests are welcome at the [GitHub repository](https://github.com/ChinchillaEnterprises/ChillMCP).
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Credits
+
+Built by [Chinchilla Enterprises](https://github.com/ChinchillaEnterprises) for the MCP ecosystem.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}