Skip to content

Commit

Permalink
docs: add server initialization instructions to quickstart guide
Browse files Browse the repository at this point in the history
  • Loading branch information
dsp-ant committed Jan 6, 2025
1 parent 96d644c commit d4285d0
Showing 1 changed file with 17 additions and 7 deletions.
24 changes: 17 additions & 7 deletions quickstart/server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -220,6 +220,16 @@ Forecast: {period['detailedForecast']}
return "\n---\n".join(forecasts)
```

### Running the server

Finally, let's initialize and run the server:

```python
if __name__ == "__main__":
# Initialize and run the server
mcp.run(transport='stdio')
```

Your server is complete! Run `uv run weather.py` to confirm that everything's working.

Let's now test your server from an existing MCP host, Claude for Desktop.
Expand All @@ -230,7 +240,7 @@ Let's now test your server from an existing MCP host, Claude for Desktop.
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/quickstart/client) tutorial to build an MCP client that connects to the server we just built.
</Note>

First, make sure you have Claude for Desktop installed. [You can install the latest version
First, make sure you have Claude for Desktop installed. [You can install the latest version
here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**

We'll need to configure Claude for Desktop for whichever MCP servers you want to use. To do this, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor. Make sure to create the file if it doesn't exist.
Expand Down Expand Up @@ -297,7 +307,7 @@ Make sure you pass in the absolute path to your server.

This tells Claude for Desktop:
1. There's an MCP server named "weather"
2. To launch it by running `uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather`
2. To launch it by running `uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather`

Save the file, and restart **Claude for Desktop**.
</Tab>
Expand Down Expand Up @@ -402,7 +412,7 @@ Create a `tsconfig.json` in the root of your project:

Now let's dive into building your server.

## Building your server
## Building your server

### Importing packages

Expand Down Expand Up @@ -752,7 +762,7 @@ Let's now test your server from an existing MCP host, Claude for Desktop.
Claude for Desktop is not yet available on Linux. Linux users can proceed to the [Building a client](/quickstart/client) tutorial to build an MCP client that connects to the server we just built.
</Note>

First, make sure you have Claude for Desktop installed. [You can install the latest version
First, make sure you have Claude for Desktop installed. [You can install the latest version
here.](https://claude.ai/download) If you already have Claude for Desktop, **make sure it's updated to the latest version.**

We'll need to configure Claude for Desktop for whichever MCP servers you want to use. To do this, open your Claude for Desktop App configuration at `~/Library/Application Support/Claude/claude_desktop_config.json` in a text editor. Make sure to create the file if it doesn't exist.
Expand All @@ -779,7 +789,7 @@ In this case, we'll add our single weather server like so:
<Tabs>
<Tab title="MacOS/Linux">
<CodeGroup>
```json Node
```json Node
{
"mcpServers": {
"weather": {
Expand Down Expand Up @@ -851,7 +861,7 @@ If the hammer icon has shown up, you can now test your server by running the fol
Since this is the US National Weather service, the queries will only work for US locations.
</Note>

## What's happening under the hood
## What's happening under the hood

When you ask a question:

Expand Down Expand Up @@ -953,4 +963,4 @@ For more advanced troubleshooting, check out our guide on [Debugging MCP](/docs/
>
Learn how to use LLMs like Claude to speed up your MCP development
</Card>
</CardGroup>
</CardGroup>

0 comments on commit d4285d0

Please sign in to comment.