Repository navigation
gryt-mcp: let an AI read and act on Gryt servers (GRYT-2005, 2/2) - #19
Merged
Merged
Conversation
A bin in this package. It joins each server given with --server as a bot with one key, kept at ~/.config/gryt-mcp/identity.json (0600), and knocks for read_messages, view_members, send_messages, delete_own_messages and view_diagnostics. The owner unticks what they don't want on each server. Tools: list_servers, list_channels, read_channel, read_thread, search, list_members, server_status, send_message, start_thread, delete_own_message. The last three are marked not read-only, so a client that honours readOnlyHint can allowlist the reads and ask before posts. Every read that returns member text starts with a line saying it's data, not instructions, and the server instructions say to post only when asked. The MCP protocol is about 90 lines here rather than the SDK as a dependency: initialize, ping, tools/list and tools/call over newline-delimited JSON on stdio is all of it we use. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…lank (GRYT-2005) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
grytchat
changed the title
grytchat
marked this pull request as ready for review
November 3, 2026 10:40
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Second layer of the Gryt MCP stack (GRYT-2005), on top of #18.
gryt-mcpis an MCP server shipped as a bin in this package. An AI client like Claude Code starts it locally, and it joins each--server name=hostas a bot, with one key at~/.config/gryt-mcp/identity.json(0600). It knocks forread_messages,view_members,send_messages,delete_own_messagesandview_diagnostics, and the owner unticks what they don't want on each server.Tools:
list_servers,list_channels,read_channel,read_thread,search,list_members,server_statussend_message(reply or thread optional),start_thread,delete_own_messageThe write tools are annotated
readOnlyHint: false, so a client can allowlist the reads and ask before every post. Every read that returns member text starts with a line saying it's data, not instructions. Nothing listens for messages or answers anyone on its own.The MCP protocol part is about 90 lines in
src/mcp/protocol.tsinstead of the SDK as a dependency. Initialize, ping, tools/list and tools/call over newline-delimited JSON is all of it this uses.Look at
WANTSinsrc/mcp/main.ts: what it asks for by default.send_messagesis in it, so the owner has to untick it for a read-only setup.stateinmain.tsuses thechannelsevent to mark a server ready again after a reconnect, sincereadyfires once.Tested
yarn test: protocol (initialize, notifications, unknown methods, read-only marking) and tools against a fake botserver_statusreturned livegryt_sfu_*numbers. Not tested with someone in voice, so the voice room list was empty.Docs: docs#181.
🤖 Generated with Claude Code