使用说明
项目简介
Them - AI Chat CLI & Discord Bot 是一个多功能AI聊天工具,允许用户通过命令行界面(CLI)或Discord机器人与多种AI模型(如GPT和Claude)进行对话。该工具的核心功能通过集成和管理 MCP (Model Context Protocol) 服务器得到增强,从而可以访问外部资源和工具,例如 GitHub 和 Brave Search。
主要功能点
- 多界面支持: 提供命令行界面和 Discord 机器人两种交互方式。
- AI 模型集成: 支持 OpenAI GPT, Anthropic Claude, DeepSeek 以及本地 Ollama 模型。
- MCP 服务器集成: 能够配置和动态管理外部 MCP 服务器,扩展 AI 功能,如集成 GitHub 工具和 Brave 搜索。
- 对话管理: 使用 SQLite 本地存储对话历史,支持列表、查看、继续和删除对话。
- 用户体验优化: 具备输入验证、错误处理和调试模式。
安装步骤
- 克隆仓库:
git clone [repository-url] cd them - 安装依赖:
npm install - 配置环境变量: 在项目根目录下创建 '.env' 文件,配置 API 密钥 (OpenAI, Anthropic, DeepSeek),如果使用 Ollama 模型,配置 Ollama 相关设置,以及可选的 Discord 机器人令牌。
- 初始化数据库:
npm run db:init - 构建项目:
npm run build
服务器配置
MCP 服务器配置位于 'src\mcp_config.ts' 文件中。项目预配置了 GitHub 和 Brave Search MCP 服务器的集成,您只需提供相应的 API 密钥即可启用这些功能。
以下是 GitHub MCP 服务器的配置示例:
{ "github": { "id": "github", "name": "GitHub Tools", "command": "node", "args": [ "node_modules/@modelcontextprotocol/server-github/dist/index.js" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_TOKEN", "PWD": "[项目根目录]" } } }
- 'id': 服务器的唯一标识符,例如 '"github"'。
- 'name': 服务器的显示名称,例如 '"GitHub Tools"'。
- 'command': 用于启动服务器的命令,通常为 '"node"'。
- 'args': 命令的参数,指向服务器的入口文件。
- 'env': 服务器所需的环境变量,例如 API 密钥和项目根目录。
基本使用方法
- Discord 机器人: 使用 'npm run bot' (开发模式) 或 'npm run bot:prod' (生产模式) 启动机器人。在 Discord 中通过斜杠命令 '/task', '/pulse search', '/ht list' 等与机器人互动。
- 命令行界面 (CLI): 在终端中使用 'them chat', 'them list', 'them show <id>', 'them continue <id>', 'them delete <id>' 等命令。
信息
分类
AI与计算