智虾助手 MCP Agent

一、简介

智虾助手 是一款基于 MCP（Model Context Protocol） 协议的轻量级智能助手。它可以充当你的私人助手， 安装非常简单——一条命令 + 一个配置即可搞定。

软件截图

二、软件下载

提供各平台预编译二进制，下载后直接运行，无需安装任何依赖。

操作系统	架构	下载链接
Windows	x86_64	mcp-agent-windows-amd64.exe
macOS	x86_64 (Intel)	mcp-agent-darwin-amd64
macOS	ARM64 (Apple Silicon)	mcp-agent-darwin-arm64
Linux	x86_64	mcp-agent-linux-amd64
Linux	ARM64	mcp-agent-linux-arm64

三、快速开始

编写最小配置文件 mcp-agent.toml，仅启用 web 终端 + time MCP Server， 配合本地 Ollama 模型，几分钟即可跑起来体验。

1. 准备模型服务

最简单的方式是使用本地 Ollama：

ollama pull qwen3.5

2. 编写最小配置

在工作目录下创建 mcp-agent.toml：

# ===== 最小快速入门配置 =====
[agent]
name        = "my-assistant"
description = "我的私人助手"

[llm]
# 本地 Ollama（默认值，可省略）
base_url = "http://127.0.0.1:11434/v1"
api_key  = "sk-your-secret-key"
model    = "qwen3.5"
stream   = true

[prompt]
system = """
你是用户的私人助手，请按用户指示进行回复，语言尽可能精简。
"""

# Web 终端：浏览器交互
[[terminals]]
type = "web"
host = "127.0.0.1"
port = 8088

[mcp]
[[mcp.servers]]
name        = "time"
description = "获取当前时间时区,查看设置定时任务等"
endpoint    = "time --with-timer"

3. 启动程序

./mcp-agent --config-file /path/to/mcp-agent.toml

看到类似下面的日志即表示启动成功：

[INFO] Loaded config from: mcp-agent.toml
[INFO] Initializing Findea MCP Agent v1.0.3 ...
[INFO]   API Base URL: http://127.0.0.1:11434/v1
[INFO]   Model: qwen3.5
[INFO]   MCP Servers: time
[OK]   Fetched N tools from 1 MCP servers
[INFO] Terminal: web (http://127.0.0.1:8088)
[INFO] Web terminal listening on http://127.0.0.1:8088

4. 与 Agent 对话

浏览器打开 http://127.0.0.1:8088， 即可与 Agent 对话。试试问它：

• 「现在几点了？」—— 会调用 time MCP Server 获取当前时间
• 「5 分钟后提醒我喝水」—— 会设置一个定时任务，到期后提醒你

四、图形界面配置

如果不想手写 TOML，智虾助手提供了 网页版配置管理界面，浏览器里填表即可创建或更新配置， 同时支持原始 TOML 编辑与语法校验，极大降低入门门槛。

# 启动网页版配置管理界面
./mcp-agent --config-ui

# 指定要管理的配置文件
./mcp-agent --config-ui --config-file /path/to/my-config.toml

👉 TOML 配置文件的完整字段说明等技术细节， 请查阅 配置详解。

五、MCP Server 模式

除默认的非 MCP 模式外，程序还支持通过 --mcp 参数将自身作为 MCP Server 对外提供服务：

• --mcp agent：将本 agent（含 LLM 与已配置的 MCP 工具）暴露为一个 chat 工具，供其他 MCP Host 作为子代理调用。该模式下不加载任何 Terminals，也不向控制台输出任何内容； 会话中的 LLM/工具调用/token 用量等事件会通过 MCP progress notification 发送给调用方 （需调用方在请求 _meta 中携带 progressToken）。
• --mcp hub：将自身作为 MCP Server 对外提供服务，聚合所有配置的 MCP Server 的工具。

# agent 模式：暴露 chat 工具（stdio）
./mcp-agent --mcp agent --mcp-transport stdio

# agent 模式：暴露 chat 工具（HTTP）
./mcp-agent --mcp agent --mcp-transport http --mcp-address 127.0.0.1:8080

# hub 模式（供其他 MCP 客户端通过标准输入输出调用）
./mcp-agent --mcp hub --mcp-transport stdio

# hub 模式（监听网络端口）
./mcp-agent --mcp hub --mcp-transport http --mcp-address 127.0.0.1:8080