MCP Study

MCP (Model Context Protocol) 学习与实践项目，包含多个可直接使用的 MCP Server。

🚀 快速安装

pip install mcp-study

📦 包含的 MCP Server

🔧 使用方式

方式一：命令行直接启动 Server

# 启动天气服务
weather-server

# 启动数据库查询服务
sql-server

方式二：在 MCP Client 中连接

{
  "mcpServers": {
    "weather": {
      "command": "weather-server"
    },
    "sql": {
      "command": "sql-server"
    }
  }
}

方式三：用 Python 代码连接

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    params = StdioServerParameters(command="weather-server")
    async with stdio_client(params) as (r, w):
        async with ClientSession(r, w) as session:
            await session.initialize()
            result = await session.call_tool("get_weather", {"city": "北京"})
            print(result.content[0].text)

asyncio.run(main())

方式四：使用 Agent（接大模型）

# 先配置 .env 文件
# DEEPSEEK_API_KEY=sk-xxx
# DEEPSEEK_BASE_URL=https://api.deepseek.com
# DEFAULT_MODEL=deepseek-chat

# 运行天气 Agent
python -m mcp_study.weather_agent

# 运行多 Server Agent
python -m mcp_study.multi_server_agent

🛠️ 工具列表

Weather Server (weather-server)

SQL Server (sql-server)

📁 项目结构

mcp-study/
├── src/mcp_study/
│   ├── weather_server.py      # 天气查询 Server
│   ├── weather_client.py      # 天气 Client（固定调用）
│   ├── weather_agent.py       # Agent（DeepSeek 驱动）
│   ├── sql_server.py          # 数据库查询 Server
│   ├── python_server.py       # Python 代码执行 Server
│   ├── multi_server_agent.py  # 多 Server Agent
│   └── config.py              # 环境变量配置
├── pyproject.toml
└── README.md

📄 License

MIT