使用说明

项目简介

DeepSeek Agent MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为LLM Agent提供工具扩展能力。它集成了天气查询、Shell命令执行和当前时间查询等功能，允许LLM客户端通过标准化的MCP协议调用这些工具，从而扩展LLM的功能边界。

主要功能点

提供天气信息查询工具（基于高德地图API）
提供执行Windows Shell命令工具
提供获取当前时间工具
通过SSE协议与客户端通信，支持流式响应

安装步骤

克隆仓库到本地：

git clone https://github.com/tujiaw/deep_seek_agent_mcp.git

进入仓库目录：

cd deep_seek_agent_mcp

创建并激活虚拟环境（推荐）：

python -m venv .venv
# Windows 系统
.venv\Scripts\activate
# Linux/Mac 系统
source .venv/bin/activate

安装项目依赖：

pip install uv
uv pip install -e .

配置环境变量：
- 复制仓库中的 '.env.example' 文件并重命名为 '.env'。
- 在 '.env' 文件中填入您的 DeepSeek API 密钥 (API_KEY) 和高德地图天气 API 密钥 (OPENWEATHER_API_KEY)。

服务器配置 (MCP 客户端配置)

MCP 客户端（例如 'llm_client.py'）需要一个 'mcp.json' 配置文件来指定如何连接到 MCP 服务器。以下是一个示例 'mcp.json' 配置文件内容，用于配置连接到本仓库实现的 MCP 服务器。客户端程序会读取此配置文件以建立连接。

{
  "mcpServers": {
    "weather_sse": {
      "url": "http://localhost:8080/sse",
      "env": {
        "OPENWEATHER_API_KEY": "YOUR_GAODE_WEATHER_API_KEY"  // [请替换为你的高德地图天气API密钥]
      }
    }
  }
}

配置参数说明:

'mcpServers': 定义可用的 MCP 服务器列表。
'weather_sse': 服务器的名称，客户端代码中会使用此名称来引用该服务器连接配置。可以自定义名称。
'url': MCP 服务器提供的 SSE (Server-Sent Events) 连接地址。本仓库实现的服务器默认地址为 'http://localhost:8080/sse'。
'env': 可选的环境变量配置，用于在客户端连接服务器时传递额外的环境变量。例如，这里配置了高德地图天气 API 密钥，以便服务器在调用天气查询工具时使用。请将 "YOUR_GAODE_WEATHER_API_KEY" 替换为您实际的高德地图天气 API 密钥。

注意： MCP 客户端 不需要 配置 MCP 服务器的启动命令或参数。客户端只需要配置如何连接到已经运行的 MCP 服务器地址（'url'）以及可选的环境变量 ('env')。

基本使用方法

启动 MCP 服务器：在仓库根目录下，运行以下命令启动 MCP 服务器：
```
uv run python ./mcp_server.py
```
服务器默认会在 'http://0.0.0.0:8080' 启动。
运行 LLM 客户端：在 另一个终端窗口 中，同样在仓库根目录下，运行 LLM 客户端：
```
uv run python ./llm_client.py
```
客户端启动后，您可以在命令行交互界面中输入问题，与 Agent 助手进行对话，体验通过 MCP 服务器扩展的工具功能。例如，您可以询问天气或让 Agent 执行简单的 Shell 命令。

关键词