Back to MCP directory
publicPublicdnsLocal runtime

mcp-chat-system

MCP是一个基于客户端-服务器架构的AI聊天系统,支持通过多种专用服务器(文件系统、Slack、Brave搜索)扩展Claude AI的功能,使其能智能访问本地文件、Slack对话和实时网络信息。

article

README

🚀 基于人工智能的聊天系统,支持多个MCP服务器

本聊天系统基于人工智能技术打造,借助强大的MCP客户端 - 服务器架构,可无缝连接多个AI服务器,为用户提供智能、便捷的信息检索与交互体验。用户无需复杂操作,系统就能根据查询智能调用不同服务器,让Claude轻松搜索本地文件、Slack历史记录或执行网络搜索。

🚀 快速开始

先决条件 🤝

您需要安装 uv 来运行此项目。

# MacOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

设置 ⚙️

  1. 克隆仓库。
git clone https://github.com/kira1228/mcp-chat-bot.git
cd mcp-chat-bot
  1. 创建.env文件并添加API密钥:
# 创建.env文件
touch .env

# 添加您的API凭证
# ANTHROPIC_API_KEY:用于Claude AI集成
echo "ANTHROPIC_API_KEY=<your api key>" >> .env

# SLACK_BOT_TOKEN & SLACK_TEAM_ID:Slack集成所需
echo "SLACK_BOT_TOKEN=<your api key>" >> .env
echo "SLACK_TEAM_ID=<your api key>" >> .env

# BRAVE_API_KEY:用于Brave搜索功能
echo "BRAVE_API_KEY=<your api key>" >> .env
  1. 创建虚拟环境并安装依赖项。
# MacOS/Linux
uv venv
source .venv/bin/activate
uv sync

# Windows
uv venv
.venv\Scripts\activate
uv sync

使用 💻

使用参数运行客户端以指定服务器路径:

uv run client.py path/to/dir/you/want/to/use

✨ 主要特性

MCP 是一个强大的客户端 - 服务器架构,使主机应用程序能够无缝连接到多个AI服务器。此系统通过专门的MCP服务器提供增强功能:

  • MCP 文件系统:允许 Claude 搜索并检索您指定的本地文件夹中的信息,使您的文档和文件对AI可用。
  • MCP Slack 服务器:连接到您的Slack工作区,使Claude能够访问和参考您的对话、频道和共享资源。
  • MCP Brave - Search:提供实时网络搜索功能,允许Claude查找并整合最新的互联网信息。

系统根据您的查询智能决定使用哪个服务器。Claude自动分析您的问题,并确定是搜索本地文件、检查Slack历史记录还是执行网络搜索——所有这些都不需要您明确指示。

🛠️ 通用架构

其核心是一个客户机 - 服务器架构,其中主机应用程序可以连接到多个服务器。

📚 参考资料

📄 许可证

此MCP服务器根据MIT许可证分发。这意味着您可以自由使用、修改和分发软件,但需遵守MIT许可证的条款和条件。更多细节,请参见项目存储库中的LICENSE文件。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client