From a15c3e8d547d2024196fbad87554d527422b8e81 Mon Sep 17 00:00:00 2001 From: Rachel Lee Nabors Date: Fri, 17 Oct 2025 21:19:27 +0100 Subject: [PATCH 1/5] Removed Arcade account pre-req and removes transport option from run server instructions (Conflicted) --- .../build-tools/create-a-mcp-server/page.mdx | 22 +------------------ 1 file changed, 1 insertion(+), 21 deletions(-) diff --git a/app/en/home/build-tools/create-a-mcp-server/page.mdx b/app/en/home/build-tools/create-a-mcp-server/page.mdx index 96dbfecac..932a07dc0 100644 --- a/app/en/home/build-tools/create-a-mcp-server/page.mdx +++ b/app/en/home/build-tools/create-a-mcp-server/page.mdx @@ -18,7 +18,6 @@ Build and run an MCP Server with tools that you define. -- An [Arcade account](https://api.arcade.dev/signup) - For this guide, we'll use [uv](https://docs.astral.sh/uv/getting-started/installation/) as our package manager. @@ -103,29 +102,10 @@ if __name__ == "__main__": Run your MCP Server using one of the with the following commands in your terminal: - - - - ```bash -uv run server.py http +uv run server.py ``` -For HTTP transport, view your server's API docs at [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs). - - - - -```bash -uv run server.py stdio -``` - - - - You should see output like this in your terminal: ```bash From bab30963d419417a65a86b99da5da361512de209 Mon Sep 17 00:00:00 2001 From: Rachel Lee Nabors Date: Fri, 17 Oct 2025 21:37:29 +0100 Subject: [PATCH 2/5] Adding a bit o context on logs and removing reference to TDK from code --- app/en/home/build-tools/tool-context/page.mdx | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/app/en/home/build-tools/tool-context/page.mdx b/app/en/home/build-tools/tool-context/page.mdx index f8a48ab43..9c406ef29 100644 --- a/app/en/home/build-tools/tool-context/page.mdx +++ b/app/en/home/build-tools/tool-context/page.mdx @@ -39,7 +39,10 @@ Let's walk through an example (or skip to [the full code](#example-code)). ### Logging -Send log messages at different levels using the `log` attribute of the `Context` object: +[ +Logging in MCP](https://modelcontextprotocol.io/specification/2025-06-18/server/utilities/logging) provides a standardized channel for servers to emit structured, leveled messages to clients. Logging is useful for observability, debugging, and user feedback during tool execution. + +You can send log messages at different levels using the `log` attribute of the `Context` object like this: ```python await context.log.debug("Debug message") @@ -228,7 +231,7 @@ async def process_with_progress( return results -# The Context provides at runtime (via TDK wrapper): +# The Context provides at runtime: # - context.user_id: ID of the user making the request # - context.get_secret(key): Retrieve a secret value (raises if missing) # - context.log.(msg): Send log messages to the client (debug/info/warning/error) From 6b2251c88be4daaa73bb0ff26e2222bbd5bd29b0 Mon Sep 17 00:00:00 2001 From: "RL \"Nearest\" Nabors" <236306+nearestnabors@users.noreply.github.com> Date: Mon, 20 Oct 2025 21:39:22 +0100 Subject: [PATCH 3/5] Update app/en/home/build-tools/tool-context/page.mdx Co-authored-by: Mateo Torres --- app/en/home/build-tools/tool-context/page.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/app/en/home/build-tools/tool-context/page.mdx b/app/en/home/build-tools/tool-context/page.mdx index 9c406ef29..198f92657 100644 --- a/app/en/home/build-tools/tool-context/page.mdx +++ b/app/en/home/build-tools/tool-context/page.mdx @@ -39,8 +39,7 @@ Let's walk through an example (or skip to [the full code](#example-code)). ### Logging -[ -Logging in MCP](https://modelcontextprotocol.io/specification/2025-06-18/server/utilities/logging) provides a standardized channel for servers to emit structured, leveled messages to clients. Logging is useful for observability, debugging, and user feedback during tool execution. +[Logging in MCP](https://modelcontextprotocol.io/specification/2025-06-18/server/utilities/logging) provides a standardized channel for servers to emit structured, leveled messages to clients. Logging is useful for observability, debugging, and user feedback during tool execution. You can send log messages at different levels using the `log` attribute of the `Context` object like this: From 6c57e80c44ef9a10032a1f39faa87fb6c55ff588 Mon Sep 17 00:00:00 2001 From: Rachel Lee Nabors Date: Mon, 20 Oct 2025 21:42:23 +0100 Subject: [PATCH 4/5] 'an MCP' not 'a MCP' --- app/en/home/build-tools/_meta.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/en/home/build-tools/_meta.tsx b/app/en/home/build-tools/_meta.tsx index 14f07d5e8..bc3c702ec 100644 --- a/app/en/home/build-tools/_meta.tsx +++ b/app/en/home/build-tools/_meta.tsx @@ -1,5 +1,5 @@ export default { - "create-a-mcp-server": "Create a MCP Server", + "create-a-mcp-server": "Create an MCP Server", "tool-context": "Tools and Context", "create-a-tool-with-auth": "Create a tool with auth", "create-a-tool-with-secrets": "Create a tool with secrets", From 1f6c317b2a5216fbe8bccd534e07e9eed56f6264 Mon Sep 17 00:00:00 2001 From: Rachel Lee Nabors Date: Mon, 20 Oct 2025 22:17:03 +0100 Subject: [PATCH 5/5] emphasize env file changes need a restart for the server --- app/en/home/build-tools/create-a-mcp-server/page.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/en/home/build-tools/create-a-mcp-server/page.mdx b/app/en/home/build-tools/create-a-mcp-server/page.mdx index 932a07dc0..4f546eec2 100644 --- a/app/en/home/build-tools/create-a-mcp-server/page.mdx +++ b/app/en/home/build-tools/create-a-mcp-server/page.mdx @@ -61,7 +61,7 @@ This generates a complete project with: - **server.py** Main server file with MCPApp and example tools - **pyproject.toml** Dependencies and project configuration -- **.env.example** Example `.env` file containing a secret required by one of the generated tools in `server.py` +- **.env.example** Example `.env` file containing a secret required by one of the generated tools in `server.py`. Environments are loaded on server start, so **if you update the `.env` file, you will need to restart your server.** `server.py` includes proper structure with command-line argument handling. It creates an `MCPApp`, defines tools with `@app.tool`, and runs with `app.run()`: