# python-mcp-servers

**Repository Path**: shoukaiseki/python-mcp-servers

## Basic Information

- **Project Name**: python-mcp-servers
- **Description**: 添加一些常用的mcp服务
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-04
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SSH MCP Server 项目

基于 MCP (Model Context Protocol) 协议的远程服务器管理工具集,提供 SSH 命令执行、飞书消息通知、延迟执行等功能。

## 📁 项目结构

```
ssh-mcp-server/
├── ssh-mcp-server/          # SSH MCP 服务 - 远程命令执行
├── feishu-mcp-server/       # 飞书 MCP 服务 - 消息通知
├── wait-mcp-server/         # 延迟执行 MCP 服务
├── metamcp/                 # MCP Gateway - 服务网关
├── requirements.txt         # Python 依赖
└── README.md               # 本文件
```

## 🚀 快速开始

### 1. 环境要求

- Python 3.13+
- Conda (推荐)
- Podman/Docker (用于容器化部署)

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

或使用 Conda:

```bash
conda create -n ssh_mcp python=3.13
conda activate ssh_mcp
pip install -r requirements.txt
```

### 3. 配置服务

每个子服务都有独立的配置文件:

#### SSH MCP Server

```bash
cd ssh-mcp-server
cp config.example.json config.json
# 编辑 config.json,填写服务器连接信息
python server.py --config config.json --mode sse
```

#### Feishu MCP Server

```bash
cd feishu-mcp-server
cp config.example.json config.json
# 编辑 config.json,填写飞书应用凭证
python server.py --config config.json
```

#### Wait MCP Server

```bash
cd wait-mcp-server
cp config.example.json config.json
python server.py --config config.json
```

### 4. 使用 MCP Gateway (推荐)

MCP Gateway 统一管理所有 MCP 服务:

```bash
cd metamcp
# 编辑 config/mcp-servers.json 配置服务地址
docker-compose up -d
```

## 🛠️ 可用工具

### SSH MCP Server

- `execute_shell_command`: 在远程服务器执行 shell 命令
- `get_server_info`: 获取服务器基本信息

### Feishu MCP Server

- `send_feishu_message`: 发送飞书文本消息
- `send_feishu_card`: 发送飞书卡片消息

### Wait MCP Server

- `wait_seconds`: 延迟指定秒数后返回

## 📝 配置文件说明

所有服务的配置都使用 JSON 格式,**不要**将包含真实凭证的 `config.json` 提交到 Git。

示例配置文件 (`config.example.json`) 可以安全提交,实际使用的 `config.json` 已被 `.gitignore` 忽略。

## 🔒 安全注意事项

1. **永远不要提交 config.json 文件** - 已配置在 `.gitignore` 中
2. **使用示例配置文件** - 提交时使用 `config.example.json`
3. **保护敏感信息** - 密码、密钥、token 等不要硬编码在代码中
4. **临时文件存放** - 所有临时文件放在 `aitmp/` 目录(已忽略)

## 🐳 容器化部署

项目支持使用 Podman/Docker 部署:

```bash
# 启动所有服务
cd metamcp
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f
```

## 📖 详细文档

各子项目的详细说明请参考对应目录的 README:

- [SSH MCP Server](ssh-mcp-server/README.md)
- [Feishu MCP Server](feishu-mcp-server/README.md)
- [Wait MCP Server](wait-mcp-server/README.md)
- [MCP Gateway](metamcp/README.md)

## 🤝 参与贡献

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 💡 提示

- 使用 `start.bat` (Windows) 或 `start.sh` (Linux/Mac) 快速启动服务
- 开发时建议使用 stdio 模式测试,生产环境使用 SSE 模式
- 定期检查并更新依赖包以确保安全性