HuLa 即时通讯应用的 MCP 服务

项目介绍

HuLa 即时通讯应用的 MCP（Message Communication Protocol）服务是一个基于 HTTP 的协议实现，用于在即时通讯应用中提供消息通信功能。该服务通过定义一组 RESTful API 和 Server-Sent Events (SSE) 接口，实现了消息的发送、接收和管理。

技术栈

• TypeScript：用于后端开发。
• Express.js：基于 Node.js 的 Web 应用框架。
• MCP SDK：提供 MCP 协议的具体实现。
• Zod：用于数据验证的库。

安装与运行

克隆仓库

使用 Git 克隆本项目：

git clone git@github.com:your-repository.git
cd huila-mcp

安装依赖

安装项目所需的依赖包：

npm install
# 或者使用 pnpm
pnpm install

启动服务

启动 MCP 服务：

npm run start
# 或者使用 pnpm
pnpm run start

默认情况下，服务将在 http://localhost:3100 上运行。

项目结构

以下是项目的目录结构：

src/
├── resources/                 # 资源模块目录
│   ├── messages.ts           # 消息资源实现
│   └── users.ts             # 用户资源实现
├── tools/                    # 工具模块目录
│   └── index.ts             # 注册工具的入口文件
└── server.ts                 # 服务初始化文件

API 说明

资源（Resources）

消息资源（Messages）

• 获取消息

  GET /messages
  

• 发送消息

  POST /messages
  

用户资源（Users）

• 获取用户列表

  GET /users
  

工具（Tools）

消息工具（Message Tool）

server.tool('message', (context) => {
    // 工具实现
});

集成到 AI 助手

移动端集成

方式一：使用 CLI 工具

1. 安装 CLI：

   npm install -g hula-mcp-cli
   

2. 启动服务：

   hula-mcp start
   

3. 配置集成：

   hula-mcp setup http://localhost:3100 --client mobile
   

方式二：手动集成

1. 启动服务。
2. 创建配置文件 config.json：

   {
     "name": "HuLa-Mobile",
     "version": "1.0.0",
     "description": "移动客户端的 MCP 配置",
     "baseUrl": "http://localhost:3100"
   }
   

服务端集成

方式一：使用 CLI 工具

hula-mcp start
hula-mcp setup http://localhost:3100 --client server

开发说明

添加新资源

在 src/resources 目录下创建或修改文件，并使用 server.resource() 方法注册资源。

添加新工具

在 src/tools/index.ts 文件中使用 server.tool() 方法注册工具。

贡献指南

1. Fork 本仓库。
2. 创建功能分支：

   git checkout -b feature/your-feature
   

3. 提交更改：

   git commit -m '添加新功能'
   

4. 推送分支：

   git push origin feature/your-feature
   

5. 创建 Pull Request。

许可证

本项目遵循 MIT 协议。