Skip to content

ql-mcp-server-fix-build-and-test.prompt.md

Latest commit

 

History

History
106 lines (70 loc) · 4.58 KB

ql-mcp-server-fix-build-and-test.prompt.md

File metadata and controls

106 lines (70 loc) · 4.58 KB
name ql-mcp-server-fix-build-and-test
description A prompt for fixing build issues for the QL MCP Server and ensuring extensive testing of the server functionality.
agent ql-mcp-tool-developer
model Claude Opus 4.6 (copilot)

ql-mcp-server-fix-build-and-test Prompt

When you encounter build issues with the QL MCP Server or need to ensure that the server functionality is thoroughly tested, use this prompt to guide your actions.

Objectives

  • Fix any build issues in the QL MCP Server codebase.
  • Ensure that all unit and integration tests for the server pass successfully.
  • Validate that the server starts up and shuts down correctly.
  • Confirm that all changes are properly bundled and that the build artifacts are up-to-date (i.e., server/dist/**).

IMPORTANT Requirement for server/dist/**

PRIOR to pushing any commit for any branch, ALWAYS run the necessary commands to ensure that the server/dist/** directory is up-to-date with the latest changes from the TypeScript source files in server/src/**. This includes running the build and bundling commands to generate the compiled JavaScript files. Thus, there MUST NOT be any git diff changes for a given commit after re-running the npm run build command from the root of the repository.

Commands

The package.json file in the root of this repository provides the scripts that are used to run specific combinations of scripts from the server/ (for build and unit tests) and client/ (for integration tests) workspaces. Instead of changing to each workspace directory, stay in the root of the repository and just use the commands available via npm run and especially those "commands" listed below.

Install dependencies for npm workspaces

Before running any build or test commands, ensure that all dependencies are installed and up-to-date by running:

npm install

Run npm run tidy command

The npm run tidy command enforces consistent linting and formatting across the workspaces and .github/** files of this repository. Run this command to fix any linting or formatting issues.

npm run tidy

Run npm run build command

Build the QL MCP Server to check for and fix any build issues.

npm run build

Run npm run test command

Re-run the build and run all server unit tests plus client integration tests to ensure everything is functioning correctly PRIOR to committing any changes.

npm run test

Starting and Stopping the QL MCP Server for Client Integration Tests

QL MCP Client integration tests require the QL MCP Server to be running. You can start the server in a separate terminal window using:

## From the `client/` directory use `npm run server:start && npm run server:wait`.
## From the root of the repository use:
npm run server:start -w client && npm run server:wait -w client

To stop the server after running the integration tests, use:

## From the `client/` directory use `npm run server:stop`.
## From the root of the repository use:
npm run server:stop -w client

Fixing Client Integration Tests for the QL MCP Server

Client integration tests are executed via the client/src/ql-mcp-client.js script.

To get help on using the MCP Client script, including help for the integration-tests subcommand, run:

node src/ql-mcp-client.js --help

When focusing specifically on fixing client integration tests, it makes more sense to change directories to cd client/ and then run the integration tests directly using node src/ql-mcp-client.js integration-tests.

Because integration tests can be time-consuming, you can run specific tests or tools as needed using the following commands:

# Run all integration tests with default settings
node src/ql-mcp-client.js integration-tests

# Run tests for specific tools
node src/ql-mcp-client.js integration-tests --tools codeql_query_run

# Run specific tests for a tool with custom timeout
node src/ql-mcp-client.js integration-tests --tools codeql_query_run --tests basic_query_run,javascript_tools_print_ast --timeout 600

References

  • package.json - The main package.json file that defines the scripts for building and testing the MCP Server, with references to the server/ and client/ workspaces.
  • server/package.json - The package.json file in the server/ workspace that defines the build and test scripts specific to the MCP Server.
  • client/package.json - The package.json file in the client/ workspace that defines the integration test scripts for the MCP Client.