# learn-mcp

**Repository Path**: shure/learn-mcp

## Basic Information

- **Project Name**: learn-mcp
- **Description**: 对 MCP 客户端和服务端的学习，其中实现了天气查询 MCP 服务，本地文件操作 MCP 服务 和 联网搜索的 MCP 服务，并通过配置文件整合所有工具实现 MCP 客户端。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-02
- **Last Updated**: 2025-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# learn-mcp

### 介绍
学习 MCP 项目的开发，有客户端和服务端，可以当做一个 AI 智能助手的产品，目前实现了天气查询 MCP 服务，本地文件操作 MCP 服务 和 联网搜索的 MCP 服务，并通过配置文件整合所有工具实现 MCP 客户端。

### 客户端

实现了整合多个 MCP 服务的工具，通过配置文件实现 MCP 服务的整合，支持自定义 MCP 服务。

配置文件格式：
```json
{
    "mcpServers": {
        "weather": {
            "type": "local",
            "command": "uv",
            "args": [
                "--directory",
                "/Users/shure/D/self/learn-mcp/mcp-server/weather/",
                "run",
                "weather.py"
            ]
        }
    }
}
```

### 服务端

实现了天气查询 MCP 服务，本地文件操作 MCP 服务 和 联网搜索的 MCP 服务。

其中联网搜索 MCP 服务使用的是: google-search 开源项目，地址：https://github.com/web-agent-master/google-search

### 开发

```shell
pip install vu

uv sync

cd mcp-client
uv run client.py
```