项目简介

Intuit是一款多功能的AI个人助手，旨在通过多种交互方式（命令行、语音）提供便捷的日常任务管理和信息查询服务。它能够管理本地文件、日历、笔记和提醒，连接Gmail和互联网，查询天气，并具备长期记忆功能。作为一个MCP服务器，Intuit还能将其丰富的功能作为标准化工具提供给其他LLM客户端。

主要功能点

文件系统索引与搜索: 构建本地文件内容的向量数据库，支持语义搜索、文件读取与管理。
网络信息获取: 提供互联网搜索功能以获取最新信息。
Gmail集成: 管理您的电子邮件，如搜索未读邮件。
天气信息: 查询全球任意地点当前天气和未来预报。
本地生产力工具: 管理日历事件、创建和搜索笔记、设置提醒。
持久化记忆: 通过向量数据库（ChromaDB）存储和检索长期记忆，使助手能保持会话上下文和用户偏好。
MCP服务器功能: 将上述所有工具以标准化的Model Context Protocol (MCP) 服务形式暴露，供其他LLM客户端调用。
语音与CLI界面: 支持通过语音或命令行交互，语音模式还提供丰富的终端用户界面（TUI）。

安装步骤

克隆仓库:

git clone https://github.com/johnrizzo1/intuit.git
cd intuit

配置API密钥: 复制 '.env.template' 为 '.env' 文件，并填入您的OpenAI、Google（用于Gmail）和天气API密钥。
```
cp .env.template .env
# 编辑 .env 文件并添加API密钥
```
对于Gmail功能，您还需要将Google API凭据JSON文件下载并放置在项目目录中，或在 '.env' 中指定其路径。
安装Python依赖:
```
uv sync
```

服务器配置

Intuit可作为MCP服务器启动，暴露其内置工具供其他MCP客户端调用。MCP客户端需要以下配置信息来连接Intuit MCP服务器。

{
  "server_name": "Intuit Tools",
  "command": "uv",
  "args": [
    "run",
    "intuit",
    "mcp",
    "start-server",
    "--host",
    "localhost",
    "--port",
    "8000"
  ],
  "description": "连接到Intuit的Model Context Protocol (MCP) 服务器，以访问其提供的日历、笔记、提醒、天气、网络搜索、文件系统、Hacker News和记忆管理等工具。MCP服务器将监听localhost:8000。"
}

参数注释:

'server_name': 服务器的显示名称，方便识别。
'command': 启动服务器所需的命令行程序，这里是'uv'。
'args': 启动命令的参数列表，包含Python模块路径、子命令、主机和端口。
- 'uv run intuit mcp start-server': Intuit启动MCP服务器的命令。
- '--host localhost': 服务器监听的IP地址。
- '--port 8000': 服务器监听的端口。
'description': 对该MCP服务器功能用途的简要说明。

基本使用方法

作为Intuit MCP服务器: 启动Intuit MCP服务器：

uv run intuit mcp start-server --host localhost --port 8000

启动后，MCP服务器将开始监听 'localhost:8000'。您可以通过其他MCP客户端（例如，一个LLM代理）连接到此地址，并调用Intuit暴露的工具。

查看MCP服务器上可用的工具: 您可以使用以下命令列出本地MCP服务器上注册的所有工具及其详细信息：

uv run intuit mcp list-mcp-tools

该命令将显示工具名称、描述以及所需的参数，方便您了解Intuit作为MCP服务器提供的具体功能。例如，您可能会看到 'calendar_add'、'notes_list'、'weather_get'、'web_search'、'take_screenshot'、'memory_add' 等工具。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息