https://github.com/dockersamples/mcp-workshop
https://github.com/dockersamples/mcp-workshop
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dockersamples/mcp-workshop
- Owner: dockersamples
- License: mit
- Created: 2025-02-12T07:24:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-13T20:16:43.000Z (over 1 year ago)
- Last Synced: 2025-05-07T10:19:01.890Z (about 1 year ago)
- Language: Python
- Size: 83 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.MD
- License: LICENSE
Awesome Lists containing this project
README
# MCP Workshop
This workshop is intended to teach you the basics of the Model Context Protocol (MCP). It will specifically have you do the following:
- Start a simple chatbot with no interactions
- Add a simple MCP server to allow the LLM to have access to realtime information
- Create your own test MCP server
## Requirements
- [Docker Desktop](https://www.docker.com)
- [VS Code](https://code.visualstudio.com/download)
- The [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) for VS Code
## Setup
1. Clone the repository:
```bash
git clone https://github.com/dockersamples/mcp-workshop.git
cd mcp-workshop
```
2. Open the project in VS Code
3. When prompted, click the **Reopen in Container** button to open the project in a devcontainer.
- **NOTE 1:** If you miss the dialog or accidentally close it, you can launch it by going to **View** -> **Command Palette...** -> **Dev Containers: Reopen in Container**
- **NOTE 2:** It may take a little while to get started, as multiple container images will be downloaded and built, Python dependencies will be installed, etc. It'll come up soon though!
4. Copy the `chatbot/.env.example` file to create a `chatbot/.env` file.
```console
cp chatbot/.env.example chatbot/.env
```
5. Update the newly created `chatbot/.env` file and add your API key:
```plaintext
LLM_SOURCE=openai
IN_CONTAINER=true # doesn't matter unless using ollama
OPENAI_API_KEY=sk-proj-hNHhZ-rest-of-key
```
You're ready to go! Go to [the Workshop Guide](./guide.md) to get started with the workshop!
## License
This workshop is licensed under the [MIT License](./LICENSE). Portions of this repo were leveraged from the [3choff/mcp-chatbot project](https://github.com/3choff/mcp-shatbot).