项目简介

CheQQme数据中心是一个内部知识与运营平台，它整合了重要链接、客户及项目记录、内部文档和任务管理。其核心特色是集成了MCP服务器功能，旨在为大型语言模型（LLM）客户端提供标准化的上下文信息和功能，从而实现AI辅助搜索和自动化。

主要功能点

资源托管与访问： 作为MCP服务器，它能够托管并管理CheQQme数据中心内的多种资源，包括用户、任务、评论、客户、项目、文档、重要URL和电话号码。LLM客户端可以通过标准接口访问这些结构化数据，获取所需上下文。
AI/语义搜索支持： 为未来的AI/语义搜索功能提供结构化数据集。LLM可以利用这些数据进行更智能的搜索和内容理解。
浏览器自动化工具集成： 集成了Playwright MCP服务器，支持浏览器自动化、网页抓取、端到端测试和用户界面验证，为LLM提供调用外部工具的能力，实现更复杂的自动化流程。
API访问与认证： MCP服务器通过HTTP API接口提供数据访问，并使用'x-api-key'头部进行认证，确保数据安全。

安装步骤

本仓库包含一个Laravel应用和一个Node.js MCP服务器。以下是MCP服务器的安装步骤：

克隆仓库并进入目录：

git clone https://github.com/Amirul96shafiq/cheqqme-data-center
cd cheqqme-data-center

安装PHP和Node.js依赖： (确保已安装PHP 8.2+, Composer, Node.js, npm)

composer install
npm install

配置主应用环境变量：

cp .env.example .env
php artisan key:generate
# 编辑 .env 文件，填写数据库、邮件等配置。特别是 MCP_ENDPOINT 和 MCP_API_KEY。

准备数据库和存储：

touch database/database.sqlite
php artisan migrate --no-interaction
php artisan db:seed --no-interaction
php artisan storage:link

配置MCP服务器环境变量：

cd mcp-server
cp .env.example .env
# 编辑 .env 文件，将 MCP_API_KEY 替换为你选择的密钥。

安装Playwright MCP (如果尚未全局安装):

npm install -g @playwright/mcp

服务器配置 (供MCP客户端连接)

MCP客户端需要知道如何启动和连接MCP服务器。以下是配置信息示例，你可以根据实际部署情况调整 'command' 和 'args'。

{
  "server_name": "CheQQme Data Center MCP",
  "command": "node",
  "args": ["/path/to/your/cheqqme-data-center/mcp-server/index.js"],
  "description": "提供CheQQme数据中心的结构化数据资源，并通过HTTP API与LLM客户端通信。",
  "endpoints": [
    {"name": "Data API", "url": "http://127.0.0.1:5000/api", "auth_header": "x-api-key"},
    {"name": "Playwright MCP", "command": "npx", "args": ["@playwright/mcp", "--headless", "--timeout-action", "5000"], "description": "用于浏览器自动化和网页交互的工具。"}
  ]
}

参数注释：

'server_name': MCP服务器的标识名称。
'command': 启动MCP服务器的命令，这里是 'node'。
'args': 传递给命令的参数，这里是MCP服务器主文件的路径。请将 '/path/to/your/cheqqme-data-center/' 替换为你的项目实际路径。
'description': 服务器功能的简要说明。
'endpoints': 服务器提供的不同接口或能力列表。
- 'Data API': 暴露CheQQme数据中心数据资源的API接口。
  - 'url': 数据API的基地址。
  - 'auth_header': API密钥认证所需的HTTP头部名称。
- 'Playwright MCP': 集成的Playwright MCP工具。
  - 'command': 启动Playwright MCP的命令，这里是 'npx'。
  - 'args': 传递给Playwright MCP命令的参数，包括无头模式和超时设置。

基本使用方法

启动Laravel应用（如果需要完整功能和数据）： 在一个终端运行：
```
composer dev
```
这将启动Laravel开发服务器、队列监听器和Vite开发服务器。
启动CheQQme Data Center MCP服务器： 在另一个终端中，导航到 'mcp-server' 目录并启动Node.js服务器：
```
cd mcp-server && node index.js
```
MCP API将在 'http://127.0.0.1:5000/api' 上可用。
通过LLM客户端访问： LLM客户端（如Cursor IDE或其他支持MCP的客户端）可以使用上述配置信息连接到此MCP服务器。一旦连接，LLM就可以发送请求来读取用户、任务、文档等资源信息，或调用Playwright MCP进行浏览器自动化操作。例如，一个简单的'curl'请求来获取用户列表：
```
curl -H "x-api-key: YOUR_KEY" http://127.0.0.1:5000/api/users
```
其中 'YOUR_KEY' 是你在 '.env' 文件中配置的 'MCP_API_KEY'。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (供MCP客户端连接)

基本使用方法

信息