[!NOTE] 我们非常需要您的帮助！如果您在Windows上尝试了askme-cli或有兼容性修复，请欢迎提交PR👏。

<div align="center">

ASKME-CLI

🤖 💬 ⚡ 🚀 ✨

</div>

一个提供用户确认界面的MCP（模型上下文协议）服务器，用于AI助手

简体中文 | 日本語

<img src="https://gips3.baidu.com/it/u=338824360,3956693493&fm=3081&app=3081&f=GIF?w=976&h=480" style="max-width: 100%; width: 800px;" alt="使用示例">

为什么

AI助手经常需要用户的确认或下一步操作，但在MCP对话中没有简单的方法来获取用户输入。

这个项目通过终端界面提供了一个个人确认端点。

如何开始

您需要配置您的MCP客户端以使用ASKME-CLI。

按照以下说明部署配置。

使用npx快速设置

# 查看帮助和配置示例
npx askme-cli help

# 直接运行（当被MCP客户端调用时）
npx askme-cli

配置MCP客户端

添加到您的MCP客户端配置文件：

Cursor（.cursor/mcp_servers.json）

{
  "mcpServers": {
    "askme-cli": {
      "command": "npx",
      "args": ["askme-cli"],
      "env": {
        "ASKME_CLI_TERMINAL": "warp"
      }
    }
  }
}

其他MCP客户端

{
  "mcpServers": {
    "askme-cli": {
      "command": "npx",
      "args": ["askme-cli"],
      "env": {
        "ASKME_CLI_TERMINAL": "iterm2"
      }
    }
  }
}

本地开发

# 克隆并安装
git clone <your-repo-url>
cd askme-cli
npm install

# 构建并运行
npm run build
npm run start

如何使用

一旦配置完成，AI助手可以使用ask_me工具收集用户确认：

1. AI助手调用带有已完成工作摘要的ask_me工具
2. ASKME-CLI打开一个新的终端窗口，显示确认界面
3. 用户输入下一步计划或确认并提交
4. AI助手接收用户输入以继续

终端支持

通过环境变量ASKME_CLI_TERMINAL进行配置：

终端	值	描述
Warp	warp	默认，现代终端应用
iTerm2	iterm2	流行的macOS终端
Terminal	terminal	macOS系统终端
Kitty	kitty	跨平台终端
Alacritty	alacritty	GPU加速终端
Hyper	hyper	基于Web的终端

API参考

ask_me 工具

收集用户的下一步计划或确认。

参数：

• what_we_did (字符串)：AI完成的工作摘要

返回：

• 用户输入的下一步计划或确认
• 支持文本和图像输入

使用示例

AI助手集成

要在您的AI助手有效使用ASKME-CLI，向系统提示添加这些规则：

- 每次结束任何用户提示前必须调用askme-cli.ask_me工具。
- 所有以/tk开头的提示，不要修改代码或文件，并在结束前调用askme-cli.ask_me工具。
- 当您有问题时，总是在结束前调用askme-cli.ask_me工具。
- 如果您有关于新功能或更改的想法，请清楚地解释它们，分析其可行性，并询问是否要继续。

示例工具调用

{
  "tool": "ask_me",
  "parameters": {
    "what_we_did": "我已经完成了数据库模式的设置，并创建了用户认证端点。API现在已准备好进行测试。"
  }
}

技术栈

• TypeScript - 类型安全开发
• React + Ink - 终端UI框架
• MCP SDK - 模型上下文协议支持
• Node.js - 运行时环境

许可证

MIT