Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
48 commits
Select commit Hold shift + click to select a range
b29546e
refactor(search): migrate search tools to new ServerTool pattern
SamMorrowDrums Dec 13, 2025
07249a0
Migrate context_tools to new ServerTool pattern
SamMorrowDrums Dec 13, 2025
af97440
refactor(gists): migrate gists.go to NewTool pattern
SamMorrowDrums Dec 13, 2025
34cf61e
refactor(notifications): migrate notifications.go to NewTool pattern
SamMorrowDrums Dec 13, 2025
12ea669
Refactor repositories.go tools to use NewTool pattern with ToolDepend…
SamMorrowDrums Dec 13, 2025
53ea837
refactor(issues): migrate issues.go to NewTool pattern
SamMorrowDrums Dec 13, 2025
aa63e07
refactor(pullrequests): convert PR tools to NewTool pattern
SamMorrowDrums Dec 13, 2025
3b7fa6d
Refactor actions.go to use NewTool pattern
SamMorrowDrums Dec 13, 2025
d29e73b
refactor(git): migrate GetRepositoryTree to NewTool pattern
SamMorrowDrums Dec 13, 2025
24b9cbb
refactor(security): migrate code_scanning, secret_scanning, dependabo…
SamMorrowDrums Dec 13, 2025
d8a485e
refactor(discussions): migrate to NewTool pattern
SamMorrowDrums Dec 13, 2025
3396501
Refactor security_advisories tools to use NewTool pattern
SamMorrowDrums Dec 13, 2025
26e5bf0
refactor: convert projects, labels, and dynamic_tools to NewTool pattern
SamMorrowDrums Dec 13, 2025
ff237aa
Add --features CLI flag for feature flag support
SamMorrowDrums Dec 13, 2025
7a78ec6
Add validation tests for tools, resources, and prompts metadata
SamMorrowDrums Dec 13, 2025
689a040
Fix default toolsets behavior when not in dynamic mode
SamMorrowDrums Dec 13, 2025
a03b3bf
refactor: address PR review feedback for toolsets
SamMorrowDrums Dec 14, 2025
8b850d0
refactor: Apply HandlerFunc pattern to resources for stateless NewToo…
SamMorrowDrums Dec 14, 2025
b13d9fe
refactor: simplify ForMCPRequest switch cases
SamMorrowDrums Dec 14, 2025
74d2c56
refactor(generate_docs): use strings.Builder and AllTools() iteration
SamMorrowDrums Dec 14, 2025
9bcf526
feat(toolsets): add AvailableToolsets() with exclude filter
SamMorrowDrums Dec 14, 2025
2142b02
refactor(generate_docs): hoist success logging to generateAllDocs
SamMorrowDrums Dec 14, 2025
6b6a874
refactor: consolidate toolset validation into ToolsetGroup
SamMorrowDrums Dec 14, 2025
011065a
refactor: rename toolsets package to registry with builder pattern
SamMorrowDrums Dec 15, 2025
cd55f6f
fix: remove unnecessary type arguments in helper_test.go
SamMorrowDrums Dec 15, 2025
7fbcae2
fix: restore correct behavior for --tools and --toolsets flags
SamMorrowDrums Dec 15, 2025
9d33e95
Move labels tools to issues toolset
SamMorrowDrums Dec 15, 2025
ad647a0
Restore labels toolset with get_label in both issues and labels
SamMorrowDrums Dec 15, 2025
315122e
Fix instruction generation and capability advertisement
SamMorrowDrums Dec 15, 2025
5f2f192
Add tests for dynamic toolset management tools
SamMorrowDrums Dec 15, 2025
3b0cc2a
Advertise all capabilities in dynamic toolsets mode
SamMorrowDrums Dec 15, 2025
988a7f0
Improve conformance test with dynamic tool calls and JSON normalization
SamMorrowDrums Dec 15, 2025
1281e4e
Add conformance-report to .gitignore
SamMorrowDrums Dec 15, 2025
58c2078
Add conformance test CI workflow
SamMorrowDrums Dec 15, 2025
80fd086
Add map indexes for O(1) lookups in Registry
SamMorrowDrums Dec 15, 2025
ab67ed6
perf(registry): O(1) HasToolset lookup via pre-computed set
SamMorrowDrums Dec 15, 2025
8f5e302
simplify: remove lazy toolsByName map - not needed for actual use cases
SamMorrowDrums Dec 15, 2025
64df513
Upgrade MCP Go SDK to v1.2.0-pre.1 and add Octicon icons to tools
SamMorrowDrums Dec 13, 2025
ed0f2d0
Update third-party licenses for SDK upgrade
SamMorrowDrums Dec 13, 2025
38a6914
Address review feedback: enum size validation, mutation fix, tests
SamMorrowDrums Dec 14, 2025
7230856
Add GitHub mark icon to server metadata
SamMorrowDrums Dec 15, 2025
1759119
Fix rebase conflicts: use Registry methods and NullTranslationHelper
SamMorrowDrums Dec 15, 2025
29583e1
Use embedded data URIs for Octicon icons
SamMorrowDrums Dec 15, 2025
6b36128
Convert icons from SVG to PNG for MCP client compatibility
SamMorrowDrums Dec 15, 2025
73a8772
Add mark-github icon for server metadata
SamMorrowDrums Dec 15, 2025
16d8b27
Add light/dark theme icons for tools, resources, and prompts
SamMorrowDrums Dec 15, 2025
3b0611e
Use 24px icons with SVG fill modification for themes
SamMorrowDrums Dec 15, 2025
dafbd5c
Add specific icons for each repository resource type
SamMorrowDrums Dec 15, 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
69 changes: 69 additions & 0 deletions .github/workflows/conformance.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
name: Conformance Test

on:
pull_request:

permissions:
contents: read

jobs:
conformance:
runs-on: ubuntu-latest

steps:
- name: Check out code
uses: actions/checkout@v6
with:
# Fetch full history to access merge-base
fetch-depth: 0

- name: Set up Go
uses: actions/setup-go@v6
with:
go-version-file: "go.mod"

- name: Download dependencies
run: go mod download

- name: Run conformance test
id: conformance
run: |
# Run conformance test, capture stdout for summary
script/conformance-test > conformance-summary.txt 2>&1 || true

# Output the summary
cat conformance-summary.txt

# Check result
if grep -q "RESULT: ALL TESTS PASSED" conformance-summary.txt; then
echo "status=passed" >> $GITHUB_OUTPUT
else
echo "status=differences" >> $GITHUB_OUTPUT
fi

- name: Generate Job Summary
run: |
# Add the full markdown report to the job summary
echo "# MCP Server Conformance Report" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "Comparing PR branch against merge-base with \`origin/main\`" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY

# Extract and append the report content (skip the header since we added our own)
tail -n +5 conformance-report/CONFORMANCE_REPORT.md >> $GITHUB_STEP_SUMMARY

echo "" >> $GITHUB_STEP_SUMMARY
echo "---" >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY

# Add interpretation note
if [ "${{ steps.conformance.outputs.status }}" = "passed" ]; then
echo "✅ **All conformance tests passed** - No behavioral differences detected." >> $GITHUB_STEP_SUMMARY
else
echo "⚠️ **Differences detected** - Review the diffs above to ensure changes are intentional." >> $GITHUB_STEP_SUMMARY
echo "" >> $GITHUB_STEP_SUMMARY
echo "Common expected differences:" >> $GITHUB_STEP_SUMMARY
echo "- New tools/toolsets added" >> $GITHUB_STEP_SUMMARY
echo "- Tool descriptions updated" >> $GITHUB_STEP_SUMMARY
echo "- Capability changes (intentional improvements)" >> $GITHUB_STEP_SUMMARY
fi
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,5 @@ bin/
# binary
github-mcp-server

.history
.history
conformance-report/
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -384,6 +384,7 @@ You can also configure specific tools using the `--tools` flag. Tools can be use
- Tools, toolsets, and dynamic toolsets can all be used together
- Read-only mode takes priority: write tools are skipped if `--read-only` is set, even if explicitly requested via `--tools`
- Tool names must match exactly (e.g., `get_file_contents`, not `getFileContents`). Invalid tool names will cause the server to fail at startup with an error message
- When tools are renamed, old names are preserved as aliases for backward compatibility. See [Deprecated Tool Aliases](docs/deprecated-tool-aliases.md) for details.

### Using Toolsets With Docker

Expand Down Expand Up @@ -459,7 +460,6 @@ The following sets of tools are available:
| `code_security` | Code security related tools, such as GitHub Code Scanning |
| `dependabot` | Dependabot tools |
| `discussions` | GitHub Discussions related tools |
| `experiments` | Experimental features that are not considered stable yet |
| `gists` | GitHub Gist related tools |
| `git` | GitHub Git API related tools for low-level Git operations |
| `issues` | GitHub Issues related tools |
Expand Down
Loading