# Python MCP Server

**Repository Path**: az13js/python_mcp

## Basic Information

- **Project Name**: Python MCP Server
- **Description**: 基于 FastMCP 框架实现的 Model Context Protocol (MCP) 服务器示例项目，为 AI 助手提供标准化的工具和资源访问接口。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-22
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python MCP Server

基于 FastMCP 框架实现的 Model Context Protocol (MCP) 服务器示例项目，为 AI 助手提供标准化的工具和资源访问接口。

## 📖 项目简介

本项目是一个轻量级的 MCP 服务器实现，展示了如何使用 Python 和 FastMCP 框架快速构建符合 MCP 标准的服务器。

## 🛠️ 技术栈

- **Python**: 3.11.1
- **FastMCP**: MCP 服务器框架
- **传输协议**: Streamable HTTP
- **开发环境**: Windows/MINGW64

*我开发机器的Python版本是3.11，其它版本应该也可以。*

## 📦 安装步骤

### 1. 克隆项目

```bash
git clone https://gitee.com/az13js/python_mcp.git
cd python_mcp
```

### 2. 创建虚拟环境

```bash
# Windows
python -m venv mcp_env
mcp_env\Scripts\activate
# Linux/Mac
python -m venv mcp_env
source mcp_env/bin/activate
```

### 3. 安装依赖

```bash
pip install fastmcp
```

## 🚀 使用方法

### 启动服务器

```bash
python my_mcp_server.py
```

服务器将在 `http://127.0.0.1:43211/mcp` 启动。

## 📋 可用工具

### 1. add - 加法运算

执行两个整数的加法运算。

**参数：**

- `a` (int): 第一个整数
- `b` (int): 第二个整数

**返回：** 两个数的和

### 2. greet - 个性化问候

生成个性化的问候语。

**参数：**

- `name` (str): 要问候的名字

**返回：** 个性化问候字符串

## 📚 可用资源

### 1. config://app - 应用配置

提供应用的版本、作者和描述信息。

### 2. greetings://{name} - 动态问候

根据名字参数生成动态问候语。

**参数：**

- `name` (str): 问候对象的名字

## 测试

测试代码参考`test.py`。正确无误时执行输出：

```bash
$ python test.py
10 + 20 = CallToolResult(content=[TextContent(type='text', text='30', annotations=None, meta=None)], structured_content={'result': 30}, meta=None, data=30, is_error=False)
Greeting: CallToolResult(content=[TextContent(type='text', text='Hello, World! Welcome to the MCP server.', annotations=None, meta=None)], structured_content={'result': 'Hello, World! Welcome to the MCP server.'}, meta=None, data='Hello, World! Welcome to the MCP server.', is_error=False)
```

## 🔧 配置说明

服务器默认配置：

- **传输协议**: Streamable HTTP
- **监听地址**: 127.0.0.1（仅本地访问）
- **端口**: 43211
- **路径**: /mcp

如需修改配置，请编辑 `my_mcp_server.py` 中的 `mcp.run()` 参数。

## 📁 项目结构

```
python_mcp/
├── my_mcp_server.py      # MCP 服务器主文件
├── DEV_LOG.md            # 开发日志
├── LICENSE               # MIT 许可证
├── README.md             # 项目说明文档
├── .gitignore           # Git 忽略文件配置
└── mcp_env/             # Python 虚拟环境（不提交到版本控制）
```

## 🤝 与 AI 助手集成

### HTTP 客户端配置

对于支持 HTTP MCP 的客户端，使用以下 URL：

```
http://127.0.0.1:43211/mcp
```

## 🔒 安全说明

- 当前配置仅监听本地地址 (127.0.0.1)，适合开发环境
- 如需远程访问，请将 `host` 修改为 `0.0.0.0` 并配置适当的防火墙规则
- 生产环境建议添加认证和 HTTPS 支持

## 🐛 常见问题

### Q: 如何更改端口号？

A: 修改 `my_mcp_server.py` 中的 `port` 参数。

### Q: 服务器无法启动怎么办？

A: 检查端口是否被占用，确保虚拟环境已激活，依赖已正确安装。

### Q: 如何支持远程访问？

A: 将 `host` 参数从 `127.0.0.1` 改为 `0.0.0.0`。