Repository navigation
Generate README.md tools section from schema #223
Description
Description
It's very easy for the README Tools section to get out of date with the real schema.
Suggestion
Include a script in the repository that uses the MCP Server schema to produce the README tools section contents. I'm hoping we can get access to this somehow without starting the server and sending an list tools request. Maybe this could go into upstream mcp-go as a utility.
In CI, generate this file and compare to the contents of the tools section in the PR, if there is a diff then error with guidance on how to run the script.
Activity
SamMorrowDrums commentedon Apr 13, 2025
That would be phenomenal generally, but would be amazing for us regardless.
LuluBeatson commentedon Jul 16, 2025
Thank you all
We now have auto-generated docs of all the tools grouped by toolset in the README.md under "Tools".
Also this docs page "Remote Server" describes how to filter the Remote MCP by toolset.
For contributors, if you edit tool descriptions, arguments or add new tools, please run this script to update the auto-generated docs
Validate remote mcp server tools (github#223)