MCP Servers

MCP_repo

Enables teams to build custom MCP servers with AI agents, supporting tool definition and Gemini API integration.

README

MCP Server + AI agent 分組實作

課程：AI Agent 開發 — MCP（Model Context Protocol）主題：（填入你們選的主題）

Server 功能總覽

說明這個 MCP Server 提供哪些 Tool

Tool 名稱	功能說明	負責組員
（範例：`get_weather`）	查詢即時天氣

組員與分工

負責功能	檔案	使用的 API
	`tools/`
	`tools/`
	`tools/`
Resource + Prompt	`server.py`	—
Agent（用 AI 產生）	`agent.py`	Gemini API

專案架構

├── server.py              # MCP Server 主程式
├── agent.py               # MCP Client + Gemini Agent（用 AI 產生）
├── tools/
│   ├── __init__.py
│   ├── example_tool.py    # 範例（可刪除）
│   ├── xxx_tool.py        # 組員 A 的 Tool
│   ├── xxx_tool.py        # 組員 B 的 Tool
│   └── xxx_tool.py        # 組員 C 的 Tool
├── requirements.txt
├── .env.example
├── .gitignore
└── README.md

使用方式

# 1. 建立虛擬環境
python3 -m venv .venv
source .venv/bin/activate

# 2. 安裝依賴
pip install -r requirements.txt

# 3. 設定 API Key
cp .env.example .env
# 編輯 .env，填入你的 GEMINI_API_KEY

# 4. 用 MCP Inspector 測試 Server
mcp dev server.py

# 5. 用 Agent 對話
python agent.py

測試結果

MCP Inspector 截圖

貼上 Inspector 的截圖（Tools / Resources / Prompts 三個分頁都要有）

Agent 對話截圖

貼上 Agent 對話的截圖（顯示 Gemini 呼叫 Tool 的過程，以及使用 /use 呼叫 Prompt 的結果）

各 Tool 說明

`tool_name`（負責：姓名）

功能：
使用 API：
參數：
回傳範例：

@mcp.tool()
def tool_name(param: str) -> str:
    """Tool 的 docstring（這就是 AI 看到的描述）"""
    ...

`tool_name`（負責：姓名）

功能：
使用 API：
參數：
回傳範例：

`tool_name`（負責：姓名）

功能：
使用 API：
參數：
回傳範例：

心得

遇到最難的問題

寫下這次實作遇到最困難的事，以及怎麼解決的

MCP 跟上週的 Tool Calling 有什麼不同？

用自己的話說說，做完後你覺得 MCP 的好處是什麼

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured