Ask Me MCP

1） 安装依赖项（如果尚未安装）

npm install   # or: pnpm install / yarn install

2） 构建服务器（生产）

npx nx build askme-server

3） 构建UI（生产）

npx nx build askme-ui

MCP配置 您的示例配置对于在stdio模式下使用内置服务器是正确的：

"ask-me-mcp": {
  "command": "node",
  "args": [
    "C:/Temp/_Work/ask-me-mcp/dist/askme-server/main.js"
  ],
  "disabled": false,
  "disabledTools": [
    "choose-next",
    "challenge-hypothesis",
    "ask-multiple-choice"
  ]
}

AskMeMCP-人在环MCP服务器

AskMeMCP是一个模型上下文协议（MCP）服务器，它使AI助手能够通过web界面请求人类输入。它实现了多种交互式工具(ask-one-question, ask-multiple-choice, challenge-hypothesis, choose-next)，允许像Claude Code这样的MCP客户端暂停执行并等待人工响应。

特性

• stdio运输：与Claude Code和其他MCP客户端直接集成
• 独立服务器：静态提供Angular UI-不需要单独的UI服务器
• 动态端口分配：如果使用默认端口，则自动查找可用端口
• 自动打开浏览器：请求到达时自动打开UI
• 实时更新：服务器发送实时通信事件
• 多种工具类型：单项问题、多项选择题、假设挑战和决策工作流程

安装

选项1：使用npx（无需安装）

您可以直接使用npx运行Ask Me MCP，而无需全局安装：

npx ask-me-mcp

注意：第一次运行此程序时，npx将要求确认临时安装该软件包。要跳过此确认，请使用：

npx --yes ask-me-mcp

选项2：全局安装

npm install -g ask-me-mcp
ask-me-mcp

不同客户端的配置

Claude桌面应用程序

添加到您的Claude配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

克劳德代码

使用CLI：

claude mcp add askme -- npx -y ask-me-mcp

或者手动添加到您的Claude Code配置中：

• macOS: ~/Library/Application Support/Claude/claude_code_config.json
• 视窗: %APPDATA%\Claude\claude_code_config.json
• Linux: ~/.config/Claude/claude_code_config.json

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

光标

添加到光标设置（中 .cursor/mcp_settings.json 在项目根目录中）：

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

带有Continue或类似扩展名的VS代码

对于支持MCP的VS Code扩展，请添加到扩展的配置中：

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp"]
    }
  }
}

端口配置

服务器有两种端口行为：

1. 自动发现（默认）：查找从3000开始的可用端口

   npx --yes ask-me-mcp

1. 固定端口：使用指定的精确端口 --port （如果端口正在使用中，则失败）

   npx --yes ask-me-mcp --port 8080

对于固定端口的Claude Code配置：

{
  "mcpServers": {
    "ask-me": {
      "command": "npx",
      "args": ["--yes", "ask-me-mcp", "--port", "8080"]
    }
  }
}

选项3：从源代码构建

# Clone the repository
git clone https://github.com/yourusername/AskMeMCP.git
cd AskMeMCP

# Install dependencies
npm install

# Build all projects
npm run build

# Configure Claude Code with full path

添加到您的Claude代码配置中：

{
  "mcpServers": {
    "ask-me": {
      "command": "node",
      "args": ["/full/path/to/AskMeMCP/dist/askme-server/main.js"]
    }
  }
}

用法

配置后，您可以使用Claude Code中的可用工具：

提问工具

Please use the ask-one-question tool to ask me what my favorite color is

问多项选择题工具

Please use the ask-multiple-choice tool with these questions:
{
  "questions": [
    {
      "text": "Which deployment environments should we target?",
      "options": ["Development", "Staging", "Production"]
    },
    {
      "text": "Which features should be included in this release?",
      "options": ["User Authentication", "Dashboard Updates", "API Improvements", "Mobile Support"]
    }
  ]
}

所有请求都将出现在web UI中，您可以在其中提供响应。对于多项选择题，您可以选择多个选项并为每个选项添加注释。

建筑

• askme服务器：stdio MCP服务器，带有用于浏览器通信的嵌入式HTTP桥
• askme ui：Angular 20+前端，使用信号进行反应式UI
• askme分享：用于前端后端通信的共享TypeScript类型

发展

# Run the UI in development mode
npx nx serve askme-ui

# Run the server in development mode
npx nx serve askme-server

# Run tests
npx nx test askme-ui
npx nx test askme-server

# Lint code
npx nx lint askme-ui
npx nx lint askme-server

故障排除

Claude代码的连接问题

如果您看到“连接失败”错误：

1. 启用调试模式：运行调试日志以查看发生了什么：

   ASK_ME_MCP_DEBUG=1 claude --debug

1. 检查服务器：测试服务器是否正常运行：

   npx --yes ask-me-mcp --help

1. 端口冲突：如果端口3000正在使用中，请指定其他端口：

   claude mcp add ask-me npx --yes ask-me-mcp --port 8080

1. 手动测试：直接运行服务器以查看任何错误：

   npx --yes ask-me-mcp

常见问题

• 首次确认：第一轮 npx ask-me-mcp 可能会要求确认。使用 npx --yes 跳过这个。
• 端口已在使用中：服务器会自动找到可用端口，但您可以使用以下命令指定一个端口 --port
• 浏览器未打开：如果浏览器没有自动打开，请手动导航到调试日志中显示的端口

许可证

麻省理工学院