MCP客户端聊天机器人

一个开源的MCP聊天机器人模板,专注于提供最佳的用户体验,支持浏览器自动化、实时语音助手等功能。

  • by Bellamy509
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 bellamy509/lakayai-complete

使用说明

MCP客户端聊天机器人

我们的目标是创造最好的聊天机器人用户体验——专注于用户在呼叫和与人工智能工具交互时感受到的快乐和直觉。

在 预览 在......下面

内置于 Vercel AI SDK 和 Next.js,该应用程序采用现代模式构建AI聊天界面。它利用了 模型上下文协议(MCP) 将外部工具无缝集成到您的聊天体验中。

目录


预览

感受一下用户体验——下面快速了解一下可能的情况。

🧩 使用Playwright MCP实现浏览器自动化

例子: 使用Microsoft的控制web浏览器 剧作家mcp 工具。

  • LLM自主决定如何使用MCP服务器的工具,多次调用它们以完成多步骤任务并返回最终消息。

示例提示:

Please go to GitHub and visit the cgoinglove/mcp-client-chatbot project.
Then, click on the README.md file.
After that, close the browser.
Finally, tell me how to install the package.

🎙️ 实时语音助手+MCP工具

这个演示展示了 基于实时语音的聊天机器人助手 使用OpenAI新的实时API构建-现在扩展为 MCP工具集成. 自然地与助手交谈,并观察它实时执行工具。

⚡️ 快速工具说明(@)&预设

在聊天过程中,通过键入以下命令快速调用任何已注册的MCP工具 @toolname. 无需死记硬背,只需输入即可 @ 并从列表中选择!

您还可以创建 工具预设 只选择您想要的MCP服务器或工具。 只需点击一下,即可在预设之间立即切换——非常适合按任务或工作流组织工具。

🧭 工具选择模式

控制每次聊天中工具的使用方式 工具选择模式 --随时切换 ⌘P.

  • 自动: 模型会在需要时自动调用工具。
  • 手册: 模型在调用工具之前会征求您的许可。
  • 无: 工具使用已完全禁用。

这使您可以根据情况在自主、引导或无工具交互之间灵活选择。


…还有更多的在等着你。 试试看它还能做什么!


入门指南

此项目使用 pnpm 作为推荐的包管理器。

# If you don't have pnpm:
npm install -g pnpm

快速入门(Docker编写版)🐳

# 1. Install dependencies
pnpm i

# 2. Enter only the LLM PROVIDER API key(s) you want to use in the .env file at the project root.
# Example: The app works with just OPENAI_API_KEY filled in.
# (The .env file is automatically created when you run pnpm i.)

# 3. Build and start all services (including PostgreSQL) with Docker Compose
pnpm docker-compose:up

快速入门(本地版本)🚀

# 1. Install dependencies
pnpm i

# 2. Create the environment variable file and fill in your .env values
pnpm initial:env # This runs automatically in postinstall, so you can usually skip it.

# 3. (Optional) If you already have PostgreSQL running and .env is configured, skip this step
pnpm docker:pg

# 4. Run database migrations
pnpm db:migrate

# 5. Start the development server
pnpm dev

# 6. (Optional) Build & start for local production-like testing
pnpm build:local && pnpm start
# Use build:local for local start to ensure correct cookie settings

打开 http://localhost:3000 在浏览器中开始。


环境变量

这 pnpm i 命令生成 .env 文件。在那里添加您的API密钥。

# === LLM Provider API Keys ===
# You only need to enter the keys for the providers you plan to use
GOOGLE_GENERATIVE_AI_API_KEY=****
OPENAI_API_KEY=****
XAI_API_KEY=****
ANTHROPIC_API_KEY=****
OPENROUTER_API_KEY=****
OLLAMA_BASE_URL=http://localhost:11434/api


# Secret for Better Auth (generate with: npx @better-auth/cli@latest secret)
BETTER_AUTH_SECRET=****

# (Optional)
# URL for Better Auth (the URL you access the app from)
BETTER_AUTH_URL=

# === Database ===
# If you don't have PostgreSQL running locally, start it with: pnpm docker:pg
POSTGRES_URL=postgres://your_username:your_password@localhost:5432/your_database_name

# Whether to use file-based MCP config (default: false)
FILE_BASED_MCP_CONFIG=false

# (Optional)
# === OAuth Settings ===
# Fill in these values only if you want to enable Google/GitHub login
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=

📘 指南

运行和配置MCP客户端聊天机器人的分步设置指南。

🔌 MCP服务器设置和工具测试

  • 如何在您的环境中添加和配置MCP服务器

🐳 Docker托管指南

  • 如何使用Docker自托管聊天机器人,包括环境配置。

▲ Vercel托管指南

  • 通过简单的设置步骤将聊天机器人部署到Vercel,以供生产使用。

🎯 系统提示和聊天定制

  • 通过自定义系统提示、用户偏好和MCP工具说明个性化您的聊天机器人体验

🔐 OAuth登录设置

  • 配置Google和GitHub OAuth以获得安全的用户登录支持。

添加类似openAI的提供者

  • 添加类似openAI的人工智能提供商

💡 提示

高级用例和额外功能,增强您的聊天机器人体验。

🧠 带有项目说明的代理聊天机器人

  • 使用MCP服务器和结构化项目说明来构建一个帮助完成特定任务的自定义助手。

💬 临时聊天窗口

  • 打开轻量级的弹出式聊天,以便快速提问或测试——与主线程分开。

🗺️ Roadmap

MCP客户端聊天机器人即将推出的计划功能:

  • [ ] MCP集成LLM工作流
  • [ ] 文件附加和图像生成
  • [ ] 协同文档编辑 (就像OpenAI Canvas:用户和助理共同编辑)
  • [ ] RAG(检索增强生成)
  • [ ] 基于Web的计算 (与 网络容器 集成)

💡 如果您有建议或需要特定功能,请创建 问题!

🙌 贡献

我们欢迎所有的贡献!Bug报告、功能想法、代码改进——一切都有助于我们构建最好的本地AI助手。

关于详细的贡献指南,请查看我们的 贡献指南.

语言翻译: 通过添加新的语言翻译,帮助我们让更多用户可以访问聊天机器人。看 语言.md 有关如何贡献翻译的说明。

让我们一起建造它🚀

💬 加入我们的Discord

与社区联系,提出问题,并在我们的官方Discord服务器上获得支持!