咕噜服务器

Name: 咕噜服务器
Author: pinkpixel-dev

作者：pinkpixel-dev6 星标更新：2025-09-23

项目介绍

Bibble - 命令行聊天机器人集成MCP

Bibble 是一个用TypeScript编写的命令行界面（CLI）聊天机器人应用程序，可以直接在您的终端中运行。它支持OpenAI、Anthropic以及与OpenAI兼容的API端点，实现了实时响应流式传输，维护聊天记忆，并作为MCP（模型上下文协议）客户端工作。

功能

通过CLI命令bibble启动聊天实例
支持OpenAI、Anthropic（Claude模型）以及与OpenAI兼容的API端点
模型输出的实时响应流式传输
具有聊天记忆的多轮对话
作为MCP客户端的功能，连接到兼容MCP的服务器
从CLI访问设置和配置选项
详细的错误处理和用户反馈
彩色文本输出和Markdown渲染
聊天历史记录的存储和检索
切换模型的能力
可配置的系统提示和用户指南

安装

预备条件

Node.js v16或更高版本
npm v7或更高版本

从npm安装

# 安装官方包
npm install -g @pinkpixel/bibble

从源码安装

克隆仓库
安装依赖项
```
npm install
```
构建项目
```
npm run build
```
全局安装
```
npm install -g .
```

使用

安装后，您可以使用命令bibble运行Bibble。如果您使用@pinkpixel范围安装了该包，也可以使用npx @pinkpixel/bibble。

启动聊天

bibble

或者

bibble chat

使用npx：

npx @pinkpixel/bibble

配置设置

bibble config

管理聊天历史

bibble history

命令

聊天命令

bibble chat - 开始聊天会话
bibble chat --model gpt-4 - 使用特定模型开始聊天
bibble chat --continue - 继续最近的聊天
bibble chat --history <id> - 加载特定的聊天历史

配置命令

bibble config list - 列出所有配置设置
bibble config set <key> <value> - 设置配置值
bibble config get <key> - 获取配置值
bibble config reset - 将配置重置为默认值
bibble config api-key - 为提供商设置API密钥
bibble config mcp-servers - 管理MCP服务器配置
bibble config user-guidelines - 配置用户指南

历史命令

bibble history list - 列出聊天历史
bibble history show <id> - 显示特定的聊天历史
bibble history delete <id> - 删除聊天历史
bibble history clear - 清除所有聊天历史
bibble history export <id> <filename> - 导出聊天历史到JSON文件
bibble history import <filename> - 从JSON文件导入聊天历史

在聊天中的命令

以下命令在聊天会话期间可用：

/help - 显示帮助信息
/exit 或 /quit - 退出聊天
/clear - 清屏
/save - 将当前聊天保存到历史
/reset - 重置当前对话

配置

Bibble将其配置存储在您家目录下的.bibble目录中。配置包括：

API密钥
默认模型设置
用户界面偏好
MCP服务器配置
用户指南（给AI的额外指令）

MCP集成

Bibble作为一个MCP客户端工作，允许它连接到兼容MCP的服务器并使用它们的工具。MCP（模型上下文协议）是一种将语言模型连接到外部工具和服务的协议。

要配置MCP服务器，请使用：

bibble config mcp-servers

开发

项目结构

/
├── src/
│   ├── commands/         # CLI命令处理器
│   ├── config/           # 配置管理
│   ├── mcp/              # MCP客户端实现
│   ├── llm/              # LLM集成
│   ├── ui/               # 终端UI组件
│   ├── utils/            # 工具函数
│   ├── index.ts          # 主入口点
│   └── types.ts          # TypeScript类型定义
├── bin/                  # 二进制可执行文件
├── scripts/              # 辅助脚本
├── package.json          # NPM包定义
└── tsconfig.json         # TypeScript配置

构建项目

npm run build

开发模式带监视

npm run dev

发布到npm

该包以@pinkpixel范围发布到npm：

# 登录到npm
npm login

# 构建项目
npm run build

# 发布包
npm publish --access public

要安装最新版本：

npm install -g @pinkpixel/bibble@latest

许可证

ISC