-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Description
Extend server/src/resources/ to serve versioned, language-specific CodeQL API documentation as MCP resources.
Resource URI Scheme
codeql://api/{language}/{version}/{module}
codeql://api/java/2.24.0/dataflow
codeql://api/javascript/latest/ast
Implementation Design
-
Resource Registry (
server/src/resources/api-reference.ts)- Define resource templates for each language × version × module combination
- Support
latestalias resolving to current CLI version - Map modules:
ast,dataflow,taint,cfg,types
-
Documentation Sources
- Fetch from CodeQL standard library QLDoc comments
- Cache generated documentation in
server/resources/api-cache/ - Implement cache invalidation on version change
-
Dynamic Resource Generation
- Use
codeql resolve qlpacksto identify installed library versions - Extract QLDoc via
codeql generate doc-indexor direct QL parsing - Format as Markdown with class hierarchies and predicate signatures
- Use
-
Resource Registration
- Register parameterized resources using MCP resource templates
- Support filtering by language in
resources/listresponses
Acceptance Criteria
- Resources available for all 9 supported languages
-
latestversion alias works correctly - Graceful fallback when docs unavailable for specific version
- Documentation cache reduces repeated generation overhead
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels