使用说明

项目简介

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 本地存储对话历史,支持列表、查看、继续和删除对话。
  • 用户体验优化: 具备输入验证、错误处理和调试模式。

安装步骤

  1. 克隆仓库:
    git clone [repository-url]
    cd them
  2. 安装依赖:
    npm install
  3. 配置环境变量: 在项目根目录下创建 '.env' 文件,配置 API 密钥 (OpenAI, Anthropic, DeepSeek),如果使用 Ollama 模型,配置 Ollama 相关设置,以及可选的 Discord 机器人令牌。
  4. 初始化数据库:
    npm run db:init
  5. 构建项目:
    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与计算