内容
> ⚡ PyPI 上，兼容支持 stdio 传输协议的 MCP # 智能终端 MCP
一个使用 **FastMCP** 构建的轻量级 **模型上下文协议（MCP）** 服务器，使 AI 助手能够通过终端、文件系统和 Python 执行工具与本地机器交互。
该项目旨在探索 MCP 如何使 AI 客户端安全地与外部工具通信并自动化本地开发工作流。
---
## ✨ 功能特点
- 执行终端命令
- 执行 Python 代码片段
- 执行 Python 文件
- 读取文件
- 写入文件
- 使用 glob 模式搜索文件
- 在文件中搜索文本
- 创建文件夹
- 删除文件夹
- 轻量级且易于扩展
- 已发布在 PyPI 上
---
## 🛠️ 技术栈
- Python 3.13+
- FastMCP
- MCP
- setuptools
---
## 📦 安装
### 使用 uv（推荐）
```bash
uv add smart_terminal_mcp
```
或直接运行安装：
```uvx smart_terminal
```
### 使用 pip
```bash
pip install smart_terminal_mcp
```
---
## 🚀 MCP
在您的 MCP 客户端中添加以下配置：
```json
"smart_terminal": {
"transport": "stdio",
"commanduvx",
"args": ["smart_terminal_mcp"]
}
}
```
配置完成后，服务器可供兼容 MCP 的 AI 客户端使用。
📂 可用工具
| 工具 | 描述 |
|------|-------------|
| bash | 执行终端命令 |
| python_code | 执行 Python 代码 |
_file | 执行 Python 文件 |
| read_file | 读取文件内容 |
_file | 创建或覆盖文件 |
| glob | 使用 glob 模式搜索文件 |
| grep | 在文件中搜索文本 |
| create_folder | 创建目录 delete_folder | 删除目录 |
---
## 📁 项目结构
```
smart_terminal_mcp/
│
├── src/
│ └── smart_terminal_mcp/
│ ├── main.py
│ ├── tools.py
│
├──.toml
├── README.md
LICENSE
```
---
## 🎯 动机
该项目的目标是通过构建一个实用的服务器来获得使用 **模型上下文协议（MCP）** 的实践经验，该服务器为 AI 助手提供了有用的本地开发工具。
它帮助我理解：
- MCP 架构
- 工具注册
- Python 打包
- PyPI 发布
- AI 工具集成
- 开发者工作流自动化
---
## 🔮 路线图
未来的改进包括：
- 工作空间沙盒化
- 安全命令执行
- 文件重命名和复制操作
- Git 集成
- 项目脚手架
- 更好的错误处理
- 跨平台支持
- 工具执行日志记录
---
## ⚠️ 免责声明
本项目仅用于教育和开发目的。
某些工具在本地机器上执行命令或修改文件。仅在受信任的环境 MCP 服务器。
---
## 📜 许可证
MIT 许可证
---
## 👨💻 作者
**Mohd Bilal**
如果您觉得这个项目有趣，请随意给仓库点星。
