Skip to content

docs: point to flashduty-cli for full open-API coverage#73

Merged
ysyneu merged 1 commit into
mainfrom
docs/cli-coverage-note
Jul 8, 2026
Merged

docs: point to flashduty-cli for full open-API coverage#73
ysyneu merged 1 commit into
mainfrom
docs/cli-coverage-note

Conversation

@ysyneu

@ysyneu ysyneu commented Jul 8, 2026

Copy link
Copy Markdown
Collaborator

The MCP server intentionally ships a curated, task-oriented toolset rather than mirroring all open-API operations (large 1:1 tool catalogs bloat model context and degrade tool selection). This PR makes that design explicit instead of leaving it as an apparent gap:

  • Server instructions (initialize response): connected agents are told the toolset is curated and that full 1:1 open-API coverage lives in flashduty-cli. Overridable via GITHUB_MCP_SERVER_INSTRUCTIONS, same translator path as all other client-facing strings.
  • README.md / README_zh.md: matching note after the intro.
  • pkg/flashduty/format.go: gci import reorder from make fmt (pre-existing drift).

Verified: make test + make build green; stdio initialize returns the instructions, and the env override works end-to-end.

The MCP server intentionally ships a curated, task-oriented toolset
rather than mirroring all open-API operations. Make that explicit:

- server-level instructions in the initialize response so connected
  agents learn that full 1:1 coverage lives in flashduty-cli
  (overridable via GITHUB_MCP_SERVER_INSTRUCTIONS like other strings)
- a matching note in README.md / README_zh.md
- gci import reorder in pkg/flashduty/format.go from make fmt
@ysyneu ysyneu merged commit 7616fb3 into main Jul 8, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant