ModelsAtlas
Explore
Atlas / MCP servers / guibibeau / Gemini Tutorial

Gemini TutorialSAFE

mcp/guibibeau/gemini-tutorial
MCP server by guibibeau · Audited 2026-10-09
⚑ Report / re-scanSource ↗

Building MCP Servers with Google Gemini

Verdict
SAFE
Grade
B
Trust score
89 /100
Exposed tools
2 2r · 0w · 0d
Transport
stdio
License
—
Stars
25
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

This repository contains the complete code for the tutorial on building Model Context Protocol (MCP) servers with Google's Gemini 2.0 model, as described in this blog post.

What is Model Context Protocol (MCP)?

MCP is an open standard developed by Anthropic that enables AI models to seamlessly access external tools and resources. It creates a standardized way for AI models to interact with tools, access the internet, run code, and more, without needing custom integrations for each tool or model.

Key benefits include:

  • Interoperability: Any MCP-compatible model can use any MCP-compatible tool
  • Modularity: Add or update tools without changing model integrations
  • Standardization: Consistent interface reduces integration complexity
  • Separation of Concerns: Clean division between model capabilities and tool functionality

Project Overview

This tutorial demonstrates how to:

  • Build a complete MCP server with Brave Search integration
  • Connect it to Google's Gemini 2.0 model
  • Create a flexible architecture for AI-powered applications

Getting Started

Prerequisites

  • Bun (for fast TypeScript execution)
  • Brave Search API key
  • Google API key for Gemini access

Installation

# Clone the repository
git clone https://github.com/GuiBibeau/mcp-gemini-tutorial.git
cd mcp-tutorial

# Install dependencies
bun install

Environment Setup

Create a .env file with your API keys:

BRAVE_API_KEY="your_brave_api_key"
GOOGLE_API_KEY="your_google_api_key"

Usage

Running the Basic Client

bun examples/basic-client.ts

Running the Gemini Integration

bun examples/gemini-tool-function.ts

Project Structure

  • src/ - Core implementation of the MCP server and tools
  • examples/ - Example clients demonstrating how to use the MCP server
  • tests/ - Test files for the project

Tools Imple

Read from source at commit c2a2714b5dffOBSERVED · 2026-10-09
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add mcp-tutorial --env BRAVE_API_KEY=${BRAVE_API_KEY} --env GOOGLE_API_KEY=${GOOGLE_API_KEY} -- npx -y mcp-tutorial
claude-desktop
{
  "mcpServers": {
    "mcp-tutorial": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-tutorial"
      ],
      "env": {
        "BRAVE_API_KEY": "${BRAVE_API_KEY}",
        "GOOGLE_API_KEY": "${GOOGLE_API_KEY}"
      }
    }
  }
}
03

Exposed tools (2)

2 read · 0 write · 0 destructive.

ToolRiskDescription
brave_local_searchreadSearch for local businesses and places using Brave Search API
brave_web_searchreadSearch the web using Brave Search API
04

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

LayerWhat it checksResult
L0Provenance & inventoryWARN
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
none-observed
Network
declared (4 observation(s))
Shell
none-observed
Dependencies
not all pinned
Secrets in source
none-found

Findings (3)

MEDIUMInventory / provenance · inv.binary · CWE-1104
bun.lockb
bun.lockb
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
LOWInventory / provenance · inv.no_license · CWE-1104
Why it matters. no LICENSE file and no repo licence
Fix. add a licence
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@google/generative-ai, @modelcontextprotocol/sdk, @types/bun
Why it matters. 3 dependency range(s) float
Fix. pin exact versions or ship a lockfile

Gates applied: no_behavioural_pass, no_license.

Audited 2026-10-09 · audit v0.4.1 · source sha c2a2714b5dfffull audit observations/trust-audit/mcp-server/guibibeau__gemini-tutorial.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-09c2a2714b5dffSAFEB89first audit
06

Questions

What is the Gemini Tutorial MCP server?

Building MCP Servers with Google Gemini

What tools does Gemini Tutorial expose?

2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is Gemini Tutorial safe to connect to an agent?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.

What credentials does Gemini Tutorial need?

It reads BRAVE_API_KEY and GOOGLE_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does Gemini Tutorial run?

It speaks stdio, so it runs as a local process your client starts. It is published on npm as mcp-tutorial.

How current is this page?

The grade is for one exact copy of the source (c2a2714b5dff), read on 2026-10-09. The repository is watched and re-audited when it changes.

Advertisement