Merge pull request #76 from modelcontextprotocol/zack-lee/clients-back
Fixed links, changed article names, added clients page back to IA
This commit is contained in:
Zachary Lee
GitHub
commit
927c3a0c2d
5 changed files with 65 additions and 37 deletions
|
|
@ -59,6 +59,13 @@ Choose the path that best fits your needs:
|
|||
>
|
||||
Check out our gallery of official MCP servers and implementations
|
||||
</Card>
|
||||
<Card
|
||||
title="Clients"
|
||||
icon="cubes"
|
||||
href="/clients"
|
||||
>
|
||||
View the list of clients that support MCP integrations
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Tutorials
|
||||
|
|
@ -67,16 +74,29 @@ Choose the path that best fits your needs:
|
|||
<Card
|
||||
title="Building a MCP client"
|
||||
icon="outlet"
|
||||
href="/building-a-client"
|
||||
href="/tutorials/building-a-client"
|
||||
>
|
||||
Learn how to build your first MCP client
|
||||
</Card>
|
||||
<Card
|
||||
title="Building MCP with Claude"
|
||||
title="Building MCP with LLMs"
|
||||
icon="comments"
|
||||
href="/building-a-client"
|
||||
href="/tutorials/building-mcp-with-llms"
|
||||
>
|
||||
Learn how to use Claude to speed up your MCP development
|
||||
Learn how to use LLMs like Claude to speed up your MCP development
|
||||
</Card>
|
||||
<Card
|
||||
title="Debugging Guide"
|
||||
icon="bug"
|
||||
href="/docs/tools/debugging">
|
||||
Learn how to effectively debug MCP servers and integrations
|
||||
</Card>
|
||||
<Card
|
||||
title="MCP Inspector"
|
||||
icon="magnifying-glass"
|
||||
href="/docs/tools/inspector"
|
||||
>
|
||||
Test and inspect your MCP servers with our interactive debugging tool
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
|
|
@ -129,26 +149,6 @@ Dive deeper into MCP's core concepts and capabilities:
|
|||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Development tools
|
||||
|
||||
Essential tools for building and debugging MCP servers:
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card
|
||||
title="Debugging Guide"
|
||||
icon="bug"
|
||||
href="/docs/tools/debugging">
|
||||
Learn how to effectively debug MCP servers and integrations
|
||||
</Card>
|
||||
<Card
|
||||
title="MCP Inspector"
|
||||
icon="magnifying-glass"
|
||||
href="/docs/tools/inspector"
|
||||
>
|
||||
Test and inspect your MCP servers with our interactive debugging tool
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Contributing
|
||||
|
||||
Want to contribute? Check out [@modelcontextprotocol](https://github.com/modelcontextprotocol) on GitHub to join our growing community of developers building with MCP.
|
||||
|
|
@ -40,13 +40,15 @@
|
|||
"navigation": [
|
||||
{
|
||||
"group": "Get Started",
|
||||
"pages": ["introduction", "quickstart", "examples"]
|
||||
"pages": ["introduction", "quickstart", "examples", "clients"]
|
||||
},
|
||||
{
|
||||
"group": "Tutorials",
|
||||
"pages": [
|
||||
"tutorials/building-a-client",
|
||||
"tutorials/building-mcp-with-claude"
|
||||
"tutorials/building-mcp-with-llms",
|
||||
"docs/tools/debugging",
|
||||
"docs/tools/inspector"
|
||||
]
|
||||
},
|
||||
{
|
||||
|
|
|
|||
|
|
@ -19,7 +19,7 @@ We'll build a server that exposes two tools: `get-alerts` and `get-forecast`. Th
|
|||
</Frame>
|
||||
|
||||
<Note>
|
||||
Servers can connect to any client. We've chosen Claude desktop here for simplicity, but we also have guides on [building your own client](/tutorials/building-a-client)
|
||||
Servers can connect to any client. We've chosen Claude desktop here for simplicity, but we also have guides on [building your own client](/tutorials/building-a-client).
|
||||
</Note>
|
||||
|
||||
<Accordion title="Why Claude for Desktop and not Claude.ai?">
|
||||
|
|
@ -1065,9 +1065,13 @@ If Claude attempts to use the tools but they fail:
|
|||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
<Note>
|
||||
For more advanced troubleshooting, check out our guide on [Debugging MCP](/docs/tools/debugging)
|
||||
</Note>
|
||||
|
||||
## Next steps
|
||||
|
||||
<CardGroup cols={1}>
|
||||
<CardGroup cols={2}>
|
||||
<Card
|
||||
title="Building a client"
|
||||
icon="outlet"
|
||||
|
|
@ -1083,10 +1087,16 @@ If Claude attempts to use the tools but they fail:
|
|||
Check out our gallery of official MCP servers and implementations
|
||||
</Card>
|
||||
<Card
|
||||
title="Core architecture"
|
||||
icon="sitemap"
|
||||
href="/docs/concepts/architecture"
|
||||
title="Debugging Guide"
|
||||
icon="bug"
|
||||
href="/docs/tools/debugging">
|
||||
Learn how to effectively debug MCP servers and integrations
|
||||
</Card>
|
||||
<Card
|
||||
title="Building MCP with LLMs"
|
||||
icon="comments"
|
||||
href="/building-mcp-with-llms"
|
||||
>
|
||||
Understand how MCP connects clients, servers, and LLMs
|
||||
Learn how to use LLMs like Claude to speed up your MCP development
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
|
@ -3,11 +3,13 @@ title: "Building MCP clients"
|
|||
description: "Learn how to build your first client in MCP"
|
||||
---
|
||||
|
||||
In this tutorial, you'll learn how to build a client application that connects to MCP servers. It helps to have gone through the [Quickstart tutorial](/quickstart) that guides you through the basic of building your first server.
|
||||
In this tutorial, you'll learn how to build a LLM-powered chatbot client that connects to MCP servers. It helps to have gone through the [Quickstart tutorial](/quickstart) that guides you through the basic of building your first server.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Python">
|
||||
|
||||
You can find the complete code for this tutorial [here.](https://gist.github.com/zckly/f3f28ea731e096e53b39b47bf0a2d4b1)
|
||||
|
||||
## System Requirements
|
||||
|
||||
Before starting, ensure your system meets these requirements:
|
||||
|
|
@ -396,13 +398,27 @@ If you see:
|
|||
|
||||
## Next steps
|
||||
|
||||
<CardGroup cols={1}>
|
||||
<CardGroup cols={2}>
|
||||
<Card
|
||||
title="Example servers"
|
||||
icon="grid"
|
||||
href="/examples"
|
||||
>
|
||||
Check out our gallery of official MCP servers and implementations
|
||||
</Card>
|
||||
<Card
|
||||
title="Clients"
|
||||
icon="cubes"
|
||||
href="/clients"
|
||||
>
|
||||
View the list of clients that support MCP integrations
|
||||
</Card>
|
||||
<Card
|
||||
title="Building MCP with LLMs"
|
||||
icon="comments"
|
||||
href="/building-mcp-with-llms"
|
||||
>
|
||||
Learn how to use LLMs like Claude to speed up your MCP development
|
||||
</Card>
|
||||
<Card
|
||||
title="Core architecture"
|
||||
|
|
|
|||
73
tutorials/building-mcp-with-llms.mdx
Normal file
73
tutorials/building-mcp-with-llms.mdx
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
---
|
||||
title: "Building MCP with LLMs"
|
||||
description: "Speed up your MCP development using LLMs such as Claude!"
|
||||
---
|
||||
|
||||
This guide will help you use LLMs to help you build custom Model Context Protocol (MCP) servers and clients. We'll be focusing on Claude for this tutorial, but you can do this with any frontier LLM.
|
||||
|
||||
## Preparing the documentation
|
||||
|
||||
Before starting, gather the necessary documentation to help Claude understand MCP:
|
||||
|
||||
1. Visit https://modelcontextprotocol.io/llms-full.txt and copy the full documentation text
|
||||
2. Navigate to either the [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) or [Python SDK repository](https://github.com/modelcontextprotocol/python-sdk)
|
||||
3. Copy the README files and other relevant documentation
|
||||
4. Paste these documents into your conversation with Claude
|
||||
|
||||
## Describing your server
|
||||
|
||||
Once you've provided the documentation, clearly describe to Claude what kind of server you want to build. Be specific about:
|
||||
|
||||
- What resources your server will expose
|
||||
- What tools it will provide
|
||||
- Any prompts it should offer
|
||||
- What external systems it needs to interact with
|
||||
|
||||
For example:
|
||||
```
|
||||
Build an MCP server that:
|
||||
- Connects to my company's PostgreSQL database
|
||||
- Exposes table schemas as resources
|
||||
- Provides tools for running read-only SQL queries
|
||||
- Includes prompts for common data analysis tasks
|
||||
```
|
||||
|
||||
## Working with Claude
|
||||
|
||||
When working with Claude on MCP servers:
|
||||
|
||||
1. Start with the core functionality first, then iterate to add more features
|
||||
2. Ask Claude to explain any parts of the code you don't understand
|
||||
3. Request modifications or improvements as needed
|
||||
4. Have Claude help you test the server and handle edge cases
|
||||
|
||||
Claude can help implement all the key MCP features:
|
||||
|
||||
- Resource management and exposure
|
||||
- Tool definitions and implementations
|
||||
- Prompt templates and handlers
|
||||
- Error handling and logging
|
||||
- Connection and transport setup
|
||||
|
||||
## Best practices
|
||||
|
||||
When building MCP servers with Claude:
|
||||
|
||||
- Break down complex servers into smaller pieces
|
||||
- Test each component thoroughly before moving on
|
||||
- Keep security in mind - validate inputs and limit access appropriately
|
||||
- Document your code well for future maintenance
|
||||
- Follow MCP protocol specifications carefully
|
||||
|
||||
## Next steps
|
||||
|
||||
After Claude helps you build your server:
|
||||
|
||||
1. Review the generated code carefully
|
||||
2. Test the server with the MCP Inspector tool
|
||||
3. Connect it to Claude.app or other MCP clients
|
||||
4. Iterate based on real usage and feedback
|
||||
|
||||
Remember that Claude can help you modify and improve your server as requirements change over time.
|
||||
|
||||
Need more guidance? Just ask Claude specific questions about implementing MCP features or troubleshooting issues that arise.
|
||||
Loading…
Reference in a new issue