Skip to content

Commit ebf75e0

Browse files
Doc changes (#517)
* Removed Arcade account pre-req and removes transport option from run server instructions (Conflicted) * Adding a bit o context on logs and removing reference to TDK from code * Update app/en/home/build-tools/tool-context/page.mdx Co-authored-by: Mateo Torres <mateo@arcade.dev> * 'an MCP' not 'a MCP' * emphasize env file changes need a restart for the server --------- Co-authored-by: Rachel Lee Nabors <nearestnabors@users.noreply.github.com> Co-authored-by: Mateo Torres <mateo@arcade.dev>
1 parent 70fdd09 commit ebf75e0

File tree

3 files changed

+7
-25
lines changed

3 files changed

+7
-25
lines changed

app/en/home/build-tools/_meta.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
export default {
2-
"create-a-mcp-server": "Create a MCP Server",
2+
"create-a-mcp-server": "Create an MCP Server",
33
"tool-context": "Tools and Context",
44
"create-a-tool-with-auth": "Create a tool with auth",
55
"create-a-tool-with-secrets": "Create a tool with secrets",

app/en/home/build-tools/create-a-mcp-server/page.mdx

Lines changed: 2 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,6 @@ Build and run an MCP server with tools that you define.
1818

1919
<GuideOverview.Prerequisites>
2020

21-
- An [Arcade account](https://api.arcade.dev/signup)
2221
- For this guide, we'll use [uv](https://docs.astral.sh/uv/getting-started/installation/) as our package manager.
2322

2423
</GuideOverview.Prerequisites>
@@ -62,7 +61,7 @@ This generates a complete project with:
6261

6362
- **server.py** Main server file with MCPApp and example tools
6463
- **pyproject.toml** Dependencies and project configuration
65-
- **.env.example** Example `.env` file containing a secret required by one of the generated tools in `server.py`
64+
- **.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.**
6665

6766
`server.py` includes proper structure with command-line argument handling. It creates an `MCPApp`, defines tools with `@app.tool`, and runs with `app.run()`:
6867

@@ -103,29 +102,10 @@ if __name__ == "__main__":
103102

104103
Run your MCP Server using one of the with the following commands in your terminal:
105104

106-
<Tabs
107-
items={["HTTP transport (default)", "stdio transport (for Claude Desktop)"]}
108-
storageKey="preferredTransport"
109-
>
110-
111-
<Tabs.Tab>
112-
113105
```bash
114-
uv run server.py http
106+
uv run server.py
115107
```
116108

117-
For HTTP transport, view your server's API docs at [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs).
118-
119-
</Tabs.Tab>
120-
<Tabs.Tab>
121-
122-
```bash
123-
uv run server.py stdio
124-
```
125-
126-
</Tabs.Tab>
127-
</Tabs>
128-
129109
You should see output like this in your terminal:
130110

131111
```bash

app/en/home/build-tools/tool-context/page.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,9 @@ Let's walk through an example (or skip to [the full code](#example-code)).
3939

4040
### Logging
4141

42-
Send log messages at different levels using the `log` attribute of the `Context` object:
42+
[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.
43+
44+
You can send log messages at different levels using the `log` attribute of the `Context` object like this:
4345

4446
```python
4547
await context.log.debug("Debug message")
@@ -228,7 +230,7 @@ async def process_with_progress(
228230
return results
229231

230232

231-
# The Context provides at runtime (via TDK wrapper):
233+
# The Context provides at runtime:
232234
# - context.user_id: ID of the user making the request
233235
# - context.get_secret(key): Retrieve a secret value (raises if missing)
234236
# - context.log.<level>(msg): Send log messages to the client (debug/info/warning/error)

0 commit comments

Comments
 (0)