Sync main → develop (PR #332)

CHANGELOG.md

@@ -4,6 +4,44 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+# [0.7.5] - 2025-09-03
+
+## 🐛 Fixes
+
+### fix: Validate ExecutableDocument in validate tool - @swcollard PR #329
+
+Contains fixes for https://github.com/apollographql/apollo-mcp-server/issues/327
+
+The validate tool was parsing the operation passed in to it against the schema but it wasn't performing the validate function on the ExecutableDocument returned by the Parser. This led to cases where missing required arguments were not caught by the Tool.
+
+This change also updates the input schema to the execute tool to make it more clear to the LLM that it needs to provide a valid JSON object
+
+## 🛠 Maintenance
+
+### test: adding a basic manual e2e test for mcp server - @alocay PR #320
+
+Adding some basic e2e tests using [mcp-server-tester](https://github.com/steviec/mcp-server-tester). Currently, the tool does not always exit (ctrl+c is sometimes needed) so this should be run manually.
+
+### How to run tests?
+Added a script `run_tests.sh` (may need to run `chmod +x` to run it) to run tests. Basic usage found via `./run_tests.sh -h`. The script does the following:
+
+1. Builds test/config yaml paths and verifies the files exist.
+2. Checks if release `apollo-mcp-server` binary exists. If not, it builds the binary via `cargo build --release`.
+3. Reads in the template file (used by `mcp-server-tester`) and replaces all `<test-dir>` placeholders with the test directory value. Generates this test server config file and places it in a temp location.
+4. Invokes the `mcp-server-tester` via `npx`.
+5. On script exit the generated config is cleaned up.
+
+### Example run:
+To run the tests for `local-operations` simply run `./run_tests.sh local-operations`
+
+### Update snapshot format - @DaleSeo PR #313
+
+Updates all inline snapshots in the codebase to ensure they are consistent with the latest insta format.
+
+### Hardcoded version strings in tests - @DaleSeo PR #305
+
+The GraphQL tests have hardcoded version strings that we need to update manually each time we release a new version. Since this isn't included in the release checklist, it's easy to miss it and only notice the test failures later.
+
 # [0.7.4] - 2025-08-27
 
 ## 🐛 Fixes

Cargo.toml

@@ -8,7 +8,7 @@ members = [
 
 [workspace.package]
 authors = ["Apollo <[email protected]>"]
-version = "0.7.4"
+version = "0.7.5"
 
 [workspace.dependencies]
 apollo-compiler = "1.27.0"

docs/source/config-file.mdx

@@ -5,32 +5,16 @@
   - /apollo-mcp-server/command-reference
 ---
 
-### Example config file
+You can configure Apollo MCP Server using a configuration file. You can also [override configuration options using environment variables](#override-configuration-options-using-environment-variables).
 
-The following example file sets your endpoint to `localhost:4001`, configures transport over Streamable HTTP, provides a GraphOS key and graph reference,
-enables introspection, and provides two local MCP operations for the server to expose.
-
-```yaml config.yaml
-endpoint: http://localhost:4001/
-transport:
-  type: streamable_http
-graphos:
-  apollo_key: <YOUR_APOLLO_KEY>
-  apollo_graph_ref: <YOUR_APOLLO_GRAPH_REF>
-introspection:
-  introspect:
-    enabled: true
-operations:
-  source: local
-  paths:
-    - relative/path/to/your/operations/userDetails.graphql
-    - relative/path/to/your/operations/listing.graphql
-```
+See the [example config file](#example-config-file) for an example.
 
 ## Configuration options
 
 All fields are optional.
 
+### Top-level options
+
 | Option           | Type                  | Default                  | Description                                                      |
 | :--------------- | :-------------------- | :----------------------- | :--------------------------------------------------------------- |
 | `custom_scalars` | `FilePath`            |                          | Path to a [custom scalar map](/apollo-mcp-server/custom-scalars) |
@@ -58,7 +42,7 @@
 
 ### Health checks
 
-These fields are under the top-level `health_check` key.
+These fields are under the top-level `health_check` key. Learn more about [health checks](/apollo-mcp-server/health-checks).
 
 | Option                        | Type       | Default     | Description                                                                        |
 | :---------------------------- | :--------- | :---------- | :--------------------------------------------------------------------------------- |
@@ -108,7 +92,7 @@
 ### Operation source
 
 These fields are under the top-level `operations` key. The available fields depend on the value of the nested `source` key.
-The default value for `source` is `"infer"`.
+The default value for `source` is `"infer"`. Learn more about [defining tools as operations](/apollo-mcp-server/define-tools).
 
 | Source             | Option   | Type             | Default | Description                                                                                                                                             |
 | :----------------- | :------- | :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -179,7 +163,7 @@
 
 ### Auth
 
-These fields are under the top-level `transport` key, nested under the `auth` key.
+These fields are under the top-level `transport` key, nested under the `auth` key. Learn more about [authorization and authentication](/apollo-mcp-server/auth).
 
 | Option                   | Type           | Default | Description                                                                                        |
 | :----------------------- | :------------- | :------ | :------------------------------------------------------------------------------------------------- |
@@ -220,3 +204,39 @@
       - mcp
       - profile
 ```
+
+## Example config file
+
+The following example file sets your endpoint to `localhost:4001`, configures transport over Streamable HTTP, enables introspection, and provides two local MCP operations for the server to expose.
+
+```yaml config.yaml
+endpoint: http://localhost:4001/
+transport:
+  type: streamable_http
+introspection:
+  introspect:
+    enabled: true
+operations:
+  source: local
+  paths:
+    - relative/path/to/your/operations/userDetails.graphql
+    - relative/path/to/your/operations/listing.graphql
+```
+
+## Override configuration options using environment variables
+
+You can override configuration options using environment variables. The environment variable name is the same as the option name, but with `APOLLO_MCP_` prefixed. You can use `__` to mark nested options.
+
+For example, to override the `introspection.execute.enabled` option, you can set the `APOLLO_MCP_INTROSPECTION__EXECUTE__ENABLED` environment variable.
+
+```sh
+APOLLO_MCP_INTROSPECTION__EXECUTE__ENABLED="true"
+```
+
+For list values, you can set the environment variable to a comma-separated list.
+
+For example, to override the `transport.auth.servers` option, you can set the `APOLLO_MCP_TRANSPORT__AUTH__SERVERS` environment variable to a comma-separated list.
+
+```sh
+APOLLO_MCP_TRANSPORT__AUTH__SERVERS='[server_url_1,server_url_2]'
+```

docs/source/install.mdx

@@ -26,14 +26,14 @@ To download a **specific version** of Apollo MCP Server (recommended for CI envi
 
 ```bash
 # Note the `v` prefixing the version number
-docker image pull ghcr.io/apollographql/apollo-mcp-server:v0.7.4
+docker image pull ghcr.io/apollographql/apollo-mcp-server:v0.7.5
 ```
 
 To download a specific version of Apollo MCP Server that is a release candidate:
 
 ```bash
 # Note the `v` prefixing the version number and the `-rc` suffix
-docker image pull ghcr.io/apollographql/apollo-mcp-server:v0.7.4-rc.1
+docker image pull ghcr.io/apollographql/apollo-mcp-server:v0.7.5-rc.1
 ```
 
 <Note>
@@ -65,7 +65,7 @@ To install or upgrade to a **specific version** of Apollo MCP Server (recommende
 
 ```bash
 # Note the `v` prefixing the version number
-curl -sSL https://mcp.apollo.dev/download/nix/v0.7.4 | sh
+curl -sSL https://mcp.apollo.dev/download/nix/v0.7.5 | sh
 ```
 
 If your machine doesn't have the `curl` command, you can get the latest version from the [`curl` downloads page](https://curl.se/download.html).
@@ -82,5 +82,5 @@ To install or upgrade to a **specific version** of Apollo MCP Server (recommende
 
 ```bash
 # Note the `v` prefixing the version number
-iwr 'https://mcp.apollo.dev/download/win/v0.7.4' | iex
+iwr 'https://mcp.apollo.dev/download/win/v0.7.5' | iex
 ```

scripts/nix/install.sh

@@ -14,7 +14,7 @@ BINARY_DOWNLOAD_PREFIX="${APOLLO_MCP_SERVER_BINARY_DOWNLOAD_PREFIX:="https://git
 
 # Apollo MCP Server version defined in apollo-mcp-server's Cargo.toml
 # Note: Change this line manually during the release steps.
-PACKAGE_VERSION="v0.7.4"
+PACKAGE_VERSION="v0.7.5"
 
 download_binary_and_run_installer() {
     downloader --check

scripts/windows/install.ps1

@@ -8,7 +8,7 @@
 
 # Apollo MCP Server version defined in apollo-mcp-server's Cargo.toml
 # Note: Change this line manually during the release steps.
-$package_version = 'v0.7.4'
+$package_version = 'v0.7.5'
 
 function Install-Binary($apollo_mcp_server_install_args) {
   $old_erroractionpreference = $ErrorActionPreference