docs: Initialize tutorials section with MCP server example
This commit adds a new `tutorials.md` file to the CLI documentation. This section is intended to house various tutorials for using Gemini CLI. The initial content includes a tutorial on setting up Model Context Protocol (MCP) servers, using the GitHub MCP server as an example. The `docs/cli/index.md` has been updated to include a link to this new tutorials section.
This commit is contained in:
parent
89aca349cf
commit
21acdee0a0
|
@ -34,5 +34,6 @@ The Gemini CLI (`packages/cli`) is the primary way users interact with the Gemin
|
||||||
- **[Commands](./commands.md):** A detailed reference for all built-in CLI commands (e.g., `/help`, `/history`, `/theme`).
|
- **[Commands](./commands.md):** A detailed reference for all built-in CLI commands (e.g., `/help`, `/history`, `/theme`).
|
||||||
- **[Configuration](./configuration.md):** Understand how to configure various aspects of the CLI.
|
- **[Configuration](./configuration.md):** Understand how to configure various aspects of the CLI.
|
||||||
- **[Themes](./themes.md)**: A guide to customizing the CLI's appearance with different themes.
|
- **[Themes](./themes.md)**: A guide to customizing the CLI's appearance with different themes.
|
||||||
|
- **[Tutorials](tutorials.md)**: A guide for mastering use of the CLI to automate your development tasks.
|
||||||
|
|
||||||
This documentation will help you become proficient in using the Gemini CLI for a wide range of tasks.
|
This documentation will help you become proficient in using the Gemini CLI for a wide range of tasks.
|
||||||
|
|
|
@ -0,0 +1,69 @@
|
||||||
|
# Tutorials
|
||||||
|
|
||||||
|
Master usage of Gemini CLI to automate development tasks.
|
||||||
|
|
||||||
|
## Setting up Model Context Protocol (MCP) Servers
|
||||||
|
|
||||||
|
> **A Note on Third-Party MCP Servers:** Before using a third-party MCP server, ensure you trust its source and understand the tools it provides. Your use of third-party servers is at your own risk.
|
||||||
|
|
||||||
|
### GitHub MCP Server
|
||||||
|
|
||||||
|
The [GitHub MCP server] provides tools for interacting with GitHub repositories, such as creating issues, commenting on pull requests, and more.
|
||||||
|
|
||||||
|
[GitHub MCP server]: https://github.com/github/github-mcp-server
|
||||||
|
|
||||||
|
#### Prerequisites
|
||||||
|
|
||||||
|
Before you begin, ensure you have the following installed and configured:
|
||||||
|
|
||||||
|
- **Docker:** Install and run [Docker].
|
||||||
|
- **GitHub Personal Access Token (PAT):** Create a new [classic] or [fine-grained] PAT with the necessary scopes.
|
||||||
|
|
||||||
|
[Docker]: https://www.docker.com/
|
||||||
|
[classic]: https://github.com/settings/tokens/new
|
||||||
|
[fine-grained]: https://github.com/settings/personal-access-tokens/new
|
||||||
|
|
||||||
|
#### Guide
|
||||||
|
|
||||||
|
##### Configure the MCP Server in `settings.json`
|
||||||
|
|
||||||
|
In your project's root directory, create or open the `.gemini/settings.json` file. Add the `mcpServers` configuration block to instruct Gemini how to launch the GitHub server.
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"mcpServers": {
|
||||||
|
"github": {
|
||||||
|
"command": "docker",
|
||||||
|
"args": [
|
||||||
|
"run",
|
||||||
|
"-i",
|
||||||
|
"--rm",
|
||||||
|
"-e",
|
||||||
|
"GITHUB_PERSONAL_ACCESS_TOKEN",
|
||||||
|
"ghcr.io/github/github-mcp-server"
|
||||||
|
],
|
||||||
|
"env": {
|
||||||
|
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
##### Set Your GitHub Token
|
||||||
|
|
||||||
|
Use an environment variable to store your PAT.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
GITHUB_PERSONAL_ACCESS_TOKEN="pat_YourActualGitHubTokenHere"
|
||||||
|
```
|
||||||
|
|
||||||
|
Gemini CLI will automatically substitute the `${GITHUB_PERSONAL_ACCESS_TOKEN}` placeholder from your `settings.json` file.
|
||||||
|
|
||||||
|
##### Launch Gemini CLI and Verify the Connection
|
||||||
|
|
||||||
|
Gemini CLI will automatically read your configuration and launch the GitHub MCP server in the background. You can ask Gemini CLI to perform GitHub actions in natural language.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
"get all open issues assigned to me in the 'foo/bar' repo and prioritize them"
|
||||||
|
```
|
Loading…
Reference in New Issue