MoMCP — documentation

文档 / Documentation

MoMCP

终端智能助手 · MCP 工具编排器

  • 运行环境 Python 3.10+
  • Textual · MCP · FastMCP
  • 配置本地存储 · 目录白名单

本页目录

SECTION 00

本站声明

重要提示：本文档的所有指南、说明和功能介绍均针对momcp-tui 主程序的最新版本。

当前最新版本为momcp-manager(0.0.7)，momcp-tui(0.1.9)。如果您正在使用旧版本，某些功能可能与文档描述不一致，或部分命令不可用。

建议：请使用以下命令升级到最新版本以体验完整功能： 

pip install --upgrade momcp-tui

SECTION 01

工具简介

MoMCP-TUI 是在终端里跑的智能助手，帮你把多家大模型和 MCP 工具串在一起用。聊天归聊天，真到了要读写文件、改代码、跑命令或者上网查资料的时候，它会自动调用对应的 MCP 工具来处理。

目前预设了 8 家模型系列，每家的 API Key 在系列内通用，切型号不用重新配。内置了文件操作、代码编辑、Shell 命令执行、天气查询和两套搜索引擎（百度千帆 + Brave Search），也能自己在配置文件里加别的 MCP 服务器，npm 装的那种也行。

聊天的回复是流式出来的，模型要是想了什么也会一并展示。点一下回复气泡就能复制内容，不用鼠标选半天。需要跑脚本、看系统状态、装包、编译代码——直接说就行，模型会自己决定要不要调 Shell 来执行。

SECTION 02

支持模型

momcp-tui 内置了以下模型系列，通过 /model list 可在程序内查看，用 /model set 型号 切换使用。目前仅支持列表内的预设选项，暂不支持自定义配置其他模型或当前模型的额外型号。

OpenAI
gpt-5.5gpt-5.4gpt-5.4-mini gpt-5.2gpt-5.1gpt-5-mini
DeepSeek
deepseek-v4-flashdeepseek-v4-pro
通义千问
qwen3.6-plusqwen3.6-flash
Kimi
kimi-k2.6kimi-k2-turbo-previewkimi-k2-0711-preview
MiniMax
MiniMax-M2.7MiniMax-M2.7-highspeed
豆包
doubao-seed-2-0-lite-260428doubao-seed-2-0-mini-260428 doubao-seed-2-0-pro-260215
智谱
glm-5.1glm-5
小米 MiMo
mimo-v2.5-promimo-v2-promimo-v2.5 mimo-v2-omnimimo-v2-flash

SECTION 03

实现原理（概览）

您在终端里输入的内容会发给当前选用的大模型服务；当任务需要读文件、改代码、执行命令或联网查资料时，程序会按 MCP 协议调用对应工具，把结果再整理成回答。整体就是「对话 → 需要时调用工具 → 继续对话」的循环。

# 您会接触到的概念
界面 终端里的图形化交互(TUI)
模型 多家云厂商 API，由您在程序里配置
工具 符合 MCP 标准的扩展能力(文件、编辑、Shell 命令、搜索等)
命令执行 大模型自主判断何时需要执行 Shell 命令，通过 subprocess 在本地运行并返回结果
自定义 可在 配置文件 中配置任意 MCP 服务器（stdio 协议），支持 npx、uvx 等命令启动
配置 配置文件（密钥、模型、MCP 服务器、目录白名单等）

SECTION 04

快速安装

建议为 MoMCP 单独准备一个 Python 3.10+ 环境。可直接通过 pip 安装并运行主程序。

环境 (Conda 示例)

# 创建并激活环境
conda create -n momcp python=3.10
conda activate momcp

安装主程序

pip install momcp-tui

查看版本

momcp-tui --version

启动

momcp-tui

启动后按提示设置用户名即可开始对话。

SECTION 05

使用指南

首次启动会提示设置用户名 (显示在消息气泡旁)。在界面中直接输入自然语言即可；斜杠命令用于模型、密钥、白名单与联网搜索配置。

模型与 API Key

查看可用模型列表，切换到指定模型，并配置对应系列的 API Key。内置支持 OpenAI、DeepSeek、通义千问、Kimi、MiniMax、豆包、智谱、小米 MiMo 等模型系列。

# 在程序内执行
/model list                查看所有预设模型
/model set deepseek-v4-flash  切换模型
/model                     查看当前模型
/api_key set YOUR_API_KEY  配置 API Key

联网搜索 (可选)

支持两种搜索引擎：百度千帆搜索和 Brave Search。配置后可在对话中自动搜索实时信息。

/web list                  列出搜索工具与配置状态
/web set YOUR_BAIDU_TOKEN  自动选择未配置的工具来设置
/web set brave-search YOUR_KEY  指定 Brave Search
/web set aisearch-mcp-server YOUR_KEY  指定百度千帆搜索

百度 Key 需在 百度千帆控制台 创建；Brave Search Key 在 Brave Search Dashboard 免费获取。

文件白名单

管理允许访问的本地目录路径，保护文件系统安全。

/allow list
/allow add ~/Documents/Project
# 添加后重启 momcp-tui 生效

Shell 命令执行

大模型可自主调用 Shell 在本地执行命令，适用于查看系统状态、运行脚本、安装包、编译代码等场景。内置安全限制：禁止交互命令、sudo、ssh 等高危操作，超时 120 秒，过长输出自动截断。

# 在对话中直接说就行，模型会自主决定是否调用 Shell
「帮我看看磁盘使用情况」
「当前目录有哪些文件」
「安装 flask 包」
「把 src 目录下的所有 .py 文件打包成 zip」

自定义 MCP 服务器

可在 配置文件 中配置任意 MCP 服务器。支持 npm、pip 等任意可执行命令。

# 配置文件
[mcp.servers.puppeteer]
command = "npx"
args = ["-y", "@anthropic/mcp-server-puppeteer"]

常用命令

快速上手高频操作，包括帮助、退出、工具查询和系统设置。

/help          分类展示完整帮助
/exit          退出
/tool list     查看所有 MCP 工具（含 run_command）
/system info   显示系统与 MCP 状态
/system reset NAME  修改助手名字

SECTION 06

功能支持

momcp-tui 内置多种 MCP 能力：Shell 命令执行、天气查询、联网搜索（百度千帆 + Brave Search）、本地文件操作与代码编辑等，由模型在对话中按需选用。联网搜索需要您先在程序内配置 API Key。同时支持通过 配置文件 自定义接入任意 MCP 服务器。

Shell 命令执行

大模型可自主在本地 Shell 中执行命令，支持运行脚本、查看系统状态、安装包、编译代码等操作。内置安全限制：禁止交互命令、sudo、ssh 等高危操作，超时 120 秒，输出过长自动截断。

样例：「帮我看看磁盘空间还剩多少，列出最大的几个目录。」

气象数据服务

按地区与时间查询天气实况、预报与空气质量等，便于安排出行与日常防护。

样例：「查一下上海明天最高气温和空气质量，适合户外跑步吗？」

联网搜索（可选）

内置百度千帆 AI Search 和 Brave Search 两种搜索引擎，可检索公开网页，补充模型训练截止日之后的资讯与动态。

样例：「搜索最近一周关于养老金调整的新闻，用五条要点总结。」

本地文件服务

在您授权的目录内列出、读写、创建与删除文件，用于整理笔记、配置与项目资料。

样例：「在当前目录新建 notes.md，写下今天的待办三件事。」

基础代码编辑

在授权路径内写入或替换代码片段，并可通过对话请模型说明含义、给出修改建议。

样例：「在 utils.py 里加一个把 ISO 日期格式化成中文的函数，并解释每行在做什么。」

自定义 MCP 服务器

支持在配置文件中接入任意 stdio 协议的 MCP 服务器，不限制编程语言，npm、pip 等均可。

样例：在 配置文件 中配置 command = "npx" + args 即可接入 Node.js 生态的 MCP 工具。

SECTION 07

问题大全

以下为安装与日常使用中的高频问题；若仍无法解决，可检查 PATH、虚拟环境是否激活，以及 配置文件是否完整。

执行 momcp-tui 提示命令不存在？

请确认已正确安装：

pip install momcp-tui
conda activate momcp   # 如果用了虚拟环境
which momcp-tui         # macOS / Linux
where momcp-tui         # Windows
momcp-manager 是什么？怎么用？

momcp-manager 是 MoMCP 的交互式管理工具，提供菜单驱动的安装、更新、卸载、启动、重置配置等操作。安装后运行：

pip install momcp-manager
momcp-manager

管理器会自动检测当前 Python 环境（含 Conda 虚拟环境），所有操作只对当前环境生效。常用快捷键：

  • [F2] — 安装或启动主程序
  • [F3] — 更新主程序
  • [F7] — 重置环境依赖（pip --force-reinstall）
  • [F8] — 重置 TUI 配置（仅删除 config.toml）
在 Conda 环境中使用需要注意什么？

momcp-tui 和 momcp-manager 均支持 Conda 虚拟环境。使用时注意：

  • 先在终端执行 conda activate 环境名 切换到目标环境，再运行 momcp-tui 或 momcp-manager
  • momcp-manager 启动时会在状态面板显示当前 Conda 环境名称和路径
  • 安装、更新、卸载都只会影响当前 Conda 环境，不会影响 base 或其他环境
提示缺少依赖包？

如果依赖反复缺失或版本冲突，推荐使用 momcp-manager 的 [F7] 重置环境依赖 功能，会自动彻底重建 momcp-tui 的依赖树。耗时较长，但能根治依赖问题。

模型报错「未配置 API Key」？

使用 /model 确认当前系列，执行 /api_key set YOUR_KEY，或重新 /model set 模型名 按提示输入。

联网搜索不可用？

使用 /web list 查看搜索工具配置状态。未配置的会显示获取地址，按需配置 API Key 后即可使用。

文件工具无法访问某目录？

该路径不在白名单中。使用 /allow add /path/to/dir 后重启程序。

如何自定义接入 MCP 服务器？

编辑 配置文件，在 [mcp.servers.*] 下配置：

[mcp.servers.my-server]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-everything"]

支持任意可执行命令，不限制编程语言。

大模型可以执行 Shell 命令吗？安全吗？

可以。momcp-tui 内置了 run_command 工具，大模型会根据对话内容自主判断是否需要调用 Shell 执行命令。安全方面有以下限制：

  • 禁止执行 sudo、su、ssh、vim、top 等交互式或高危命令
  • 命令超时 120 秒，防止长时间占用
  • 输出过长时自动截断，避免刷屏
  • 命令在启动时的工作区根目录下执行
如何复制聊天回复的内容？

直接点击聊天区域中的助手回复气泡，内容会自动复制到系统剪贴板，并显示「已复制到剪贴板」提示。

如何清空或重置 MoMCP 配置？

推荐使用 momcp-manager 的 [F8] 重置 MoMCP 配置 功能，仅删除 TUI 的配置文件 config.toml，不影响管理器自身的设置。