https://github.com/perseus-computing-llc/slack-perseus-agent
Perseus-powered Slack agent via MCP — live project context for developer teams. Built for the Slack Agent Builder Challenge 2026.
https://github.com/perseus-computing-llc/slack-perseus-agent
agent ai developer-tools hackathon mcp perseus slack
Last synced: about 6 hours ago
JSON representation
Perseus-powered Slack agent via MCP — live project context for developer teams. Built for the Slack Agent Builder Challenge 2026.
- Host: GitHub
- URL: https://github.com/perseus-computing-llc/slack-perseus-agent
- Owner: Perseus-Computing-LLC
- License: mit
- Created: 2026-06-19T20:16:14.000Z (8 days ago)
- Default Branch: main
- Last Pushed: 2026-06-19T21:56:57.000Z (8 days ago)
- Last Synced: 2026-06-19T22:18:12.570Z (8 days ago)
- Topics: agent, ai, developer-tools, hackathon, mcp, perseus, slack
- Language: Python
- Homepage: https://slackhack.devpost.com/
- Size: 4.73 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Perseus for Slack — Live Context for Developer Teams
[](LICENSE)
[](https://slackhack.devpost.com/)
**Perseus brings live project context into Slack via MCP** — answering "what's running?", "what did we decide?", and "where's that code?" so developer teams ship faster without leaving chat.
Built for the **Slack Agent Builder Challenge 2026** (New Slack Agent track) using **Perseus MCP server integration**.
## What it does
- `@perseus services` — check service health from Slack
- `@perseus memory ` — recall team decisions and context
- `@perseus search ` — find code across the project
- `@perseus onboard` — new team member context dump
- `@perseus ask ` — natural language project queries
## Architecture
```
Slack User → Slack Agent (Bolt) → MCP → Perseus Server
├── perseus_services (health)
├── perseus_memory (Mimir recall)
├── perseus_read (file inspection)
├── perseus_list ─┐ code search:
│ ├─ enumerate + grep
├── perseus_read ─┘ (client-side)
└── perseus_get_context (NL context)
```
## Why MCP
The Slack challenge requires MCP server integration, Slack AI, or Real-Time Search. Perseus ships as a **production MCP server** with 27+ tools for context resolution — we're wiring real infrastructure into Slack, not building a toy.
## Quickstart
```bash
pip install -r requirements.txt
cp .env.example .env # fill in SLACK_BOT_TOKEN, PERSEUS_MCP_URL
python src/app.py
```
## Project structure
```
├── src/ # Slack Bolt agent (Python)
│ ├── app.py # Main app, mentions + slash commands
│ ├── mcp_client.py # MCP client (Perseus server)
│ ├── handlers.py # Intent routing
│ └── blocks.py # Slack Block Kit formatters
├── demo/ # Demo video script + transcript
├── docs/ # Architecture docs + submission
└── assets/ # Architecture diagram
```
## Hackathon
- **Challenge:** [Slack Agent Builder Challenge](https://slackhack.devpost.com/)
- **Track:** New Slack Agent (MCP server integration)
- **Deadline:** July 13, 2026
- **Prize:** $42,000 + Dreamforce trip
## License
MIT — [LICENSE](LICENSE)