Slack

FastMCP v2를 사용하여 Slack API와 연동되는 MCP(Model Context Protocol) 서버를 구축하는 프로젝트

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hyunol7-slack-mcp": {
      "command": "python",
      "args": [
        "slack_mcp_server.py"
      ],
      "env": {
        "TEAM_ID": "A08TL5C310F",
        "SLACK_BOT_TOKEN": "xoxb-your-slack-bot-token-here",
        "TEST_CHANNEL_ID": "C08UATXFD8B",
        "TEST_CHANNEL_NAME": "testhyun"
      }
    }
  }
}

You build an MCP server that connects Slack to an MCP client workflow using FastMCP v2. It enables you to send messages, read channels, fetch history, and manage users directly from Slack through a programmable, extensible interface that supports UTF-8 Korean text and seamless integration with your existing MCP tooling.

How to use

Use an MCP client to interact with the Slack MCP Server and perform these actions: send messages to Slack channels, retrieve channel lists, view recent channel history, send direct messages to users, and fetch the workspace user list. All interactions are exposed as MCP endpoints you can call from your client, enabling automation and integration with your workflows.

How to install

Prerequisites you need on your machine are Python and pip. You will install dependencies, set up an optional virtual environment, run the MCP server, and then run a test script to verify everything works.

cd 0527/slack-mcp
pip install -r requirements.txt

Optional virtual environment (recommended) creates an isolated Python runtime for you.

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate

Start the MCP server so it can listen for MCP client calls.

python slack_mcp_server.py

Run a basic test script to ensure endpoints respond as expected.

python main.py

Additional sections

Configuration and usage notes help you connect Slack to your MCP workflow securely and reliably. You must create a Slack app, grant the required scopes, install the app to your workspace, and set up environment variables to supply the credentials and identifiers used by the server.

Environment variables you configure in the project’s root form the bridge to Slack. You place them in a .env file and the server reads them at startup.

Key notes to consider when you set up and operate the server include ensuring the bot token has the necessary permissions, inviting the bot to channels you want to use, and respecting Slack API rate limits during automated operations.

Typical usage considerations also cover encoding, especially when you work with Korean text. UTF-8 encoding is used to ensure messages render correctly in Slack.

If you encounter access or permission problems, verify that the bot token has all required scopes and that the bot is a member of the channels you query or post to.

Environment configuration example

# .env 文件
SLACK_BOT_TOKEN=xoxb-your-slack-bot-token-here
TEST_CHANNEL_ID=C08UATXFD8B
TEST_CHANNEL_NAME=testhyun
TEAM_ID=A08TL5C310F

Available tools

send_slack_message

Send a message to a specified Slack channel with UTF-8 support for Korean text.

get_slack_channels

Retrieve a list of channels accessible by the bot, including their IDs and privacy status.

get_slack_channel_history

Fetch recent messages from a specific channel, with a configurable limit.

send_slack_direct_message

Send a direct 1:1 message to a specific Slack user.

get_slack_users

Retrieve the workspace user list to reference IDs for messaging and administration.