Skip to content

Add flexibility around server instructions for search-related tools #1181

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 6, 2025
+6 −6
Merged

Add flexibility around server instructions for search-related tools #1181

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
fdc1cb4
make instructions for flexible around search tools
tommaso-moro Oct 6, 2025
a5fd807
swap sections
tommaso-moro Oct 6, 2025
57ba69f
Merge branch 'main' into tommy/server-instructions-enhancement
tommaso-moro Oct 6, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions pkg/github/instructions.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,15 @@ func GenerateInstructions(enabledToolsets []string) string {
}

// Base instruction with context management
baseInstruction := `The GitHub MCP Server provides tools to interact with GitHub platform.

Tool selection guidance:
1. Use 'list_*' tools for broad, simple retrieval and pagination of all items of a type (e.g., all issues, all PRs, all branches) with basic filtering.
2. Use 'search_*' tools for targeted queries with specific criteria, keywords, or complex filters (e.g., issues with certain text, PRs by author, code containing functions).
baseInstruction := `The GitHub MCP Server provides tools to interact with GitHub.

Context management:
1. Use pagination whenever possible with batches of 5-10 items.
2. Use minimal_output parameter set to true if the full information is not needed to accomplish a task.`
2. Use minimal_output parameter set to true if the full information is not needed to accomplish a task.

Tool selection guidance:
1. Use 'list_*' tools for broad, simple retrieval and pagination of all items of a type (e.g., all issues, all PRs, all branches) with basic filtering.
2. Use tools containing 'search' in their name for targeted queries with specific criteria, keywords, or complex filters (e.g., issues with certain text, PRs by author, code containing functions).`

allInstructions := []string{baseInstruction}
allInstructions = append(allInstructions, instructions...)
Expand Down
Loading