weishauptandClaude Opus 5.5
c50f770f77
Connects to Rizon over TLS, answers PINGs, buffers recent channel messages, and exposes join/leave/send/read/list-users tools limited to channels in config.json. Never posts unprompted. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
# irc-mcp
|
|
|
|
A small MCP server that gives Claude Code an IRC connection.
|
|
|
|
- Connects to `irc.rizon.net:6697` over TLS as `tpuahsiew_claude`, and uses a fallback nick if that one is taken
|
|
- Answers server PINGs, sends its own keepalive PING, and reconnects automatically
|
|
- Can only join channels listed in `allowed_channels` in `config.json` (re-read on every call, so edits apply right away)
|
|
- Keeps a rolling buffer of recent messages per joined channel (`buffer_size`, default 200)
|
|
- Never posts on its own. It sends chat only through `send_message`, and does not answer CTCP
|
|
|
|
## Tools
|
|
|
|
| Tool | What it does |
|
|
|---|---|
|
|
| `irc_status` | Connection state, nick, joined and allowed channels |
|
|
| `join_channel` | Join an allowed channel |
|
|
| `leave_channel` | Part a channel |
|
|
| `send_message` | Post to a joined channel (max 10 lines, paced 1/s) |
|
|
| `read_messages` | Last N buffered messages (`include_events` adds joins, parts, etc.) |
|
|
| `list_users` | Nicks currently in a joined channel |
|
|
|
|
The buffer only holds messages seen since the bot joined in the current Claude Code session.
|
|
|
|
## Setup (Windows)
|
|
|
|
```powershell
|
|
python -m venv .venv
|
|
.venv\Scripts\python.exe -m pip install -r requirements.txt
|
|
claude mcp add --scope user irc -- C:\wallpapers\irc-mcp\.venv\Scripts\python.exe C:\wallpapers\irc-mcp\server.py
|
|
```
|
|
|
|
Set `IRC_MCP_CONFIG` to use a config file somewhere else.
|