What is Xiaozhi Mcp Mobile

xiaozhi-mcp-mobile is a mobile application built with React Native and Expo, designed for managing and utilizing MCP (Model Control Protocol) services. It allows users to connect to MCP servers, activate various tools (such as calculators and Gaode map services), and monitor the status of script executions.

Use cases

Use cases for xiaozhi-mcp-mobile include managing logistics operations, monitoring transportation routes, utilizing weather data for planning, and executing scripts for automated tasks.

How to use

To use xiaozhi-mcp-mobile, clone the repository, install the dependencies using npm or yarn, and start the development server with Expo. Users can then connect to an MCP server by entering its address in the API configuration section and clicking the connect button.

Key features

Key features include MCP server connection management, script service control (start/stop), tool functionality management, integration with Gaode map API (route planning, weather queries), and a calculator feature.

Where to use

xiaozhi-mcp-mobile can be used in various fields that require remote management and monitoring of services, such as logistics, transportation, and any application that benefits from real-time data processing and tool integration.

小智MCP工具

小智MCP工具是一个基于React Native和Expo构建的移动应用，用于管理和使用MCP（Model Control Protocol）服务。此应用允许用户连接到MCP服务器，启用各种工具（如计算器、高德地图服务等），并监控脚本的运行状态。

功能特点

• MCP服务器连接管理
• 脚本服务启动/停止控制
• 工具功能开关管理
• 高德地图API集成（路线规划、天气查询）
• 计算器功能展示

安装

前提条件

• Node.js 16.x 或更高版本
• npm 或 yarn
• Expo CLI
• Android Studio (Android开发) / Xcode (iOS开发)

步骤

1. 克隆仓库

git clone https://github.com/your-username/xiaozhi-mcp-mobile.git
cd xiaozhi-mcp-mobile

2. 安装依赖

npm install
# 或
yarn install

3. 启动开发服务器

npx expo start

4. 在模拟器或设备上运行
   • 按 a 在Android模拟器中运行
   • 按 i 在iOS模拟器中运行
   • 使用Expo Go应用扫描二维码在实体设备上运行

构建APK

要构建Android APK，请按照以下步骤操作：

1. 安装EAS CLI

npm install -g eas-cli

2. 登录到Expo账户

eas login

3. 初始化EAS项目（如果尚未完成）

eas init

4. 构建APK

eas build --platform android --profile apk

5. 等待构建完成，然后从提供的链接下载APK文件

项目结构

xiaozhi-mcp-mobile/
├── app/               # Expo Router应用入口
│   ├── (tabs)/        # 底部标签页面
│   │   ├── index.tsx  # 主页
│   │   ├── settings.tsx # 设置页面
│   │   └── _layout.tsx  # 标签布局
│   ├── script.tsx     # 脚本详情页面
│   └── _layout.tsx    # 应用根布局
├── src/               # 源代码
│   ├── components/    # UI组件
│   ├── context/       # 状态管理上下文
│   └── services/      # 服务逻辑
├── assets/            # 静态资源
│   ├── fonts/         # 字体
│   └── images/        # 图片
├── app.json           # Expo配置
└── package.json       # 依赖和脚本

技术栈

• React Native - 跨平台移动应用框架
• Expo - React Native开发工具和服务
• Expo Router - 应用路由和导航
• React Native Paper - UI组件库
• AsyncStorage - 本地存储
• WebSocket - MCP服务通信

连接到MCP服务器

1. 在应用主页选择"前往设置"
2. 在"API配置"部分输入MCP服务器地址（格式：wss://server-address:port/path）
3. 返回主页，点击"连接"按钮
4. 连接成功后，即可启用各种工具和脚本服务

贡献代码

欢迎贡献代码！请阅读贡献指南获取更多信息。

许可证

MIT

联系方式

• 项目维护者: Your Name
• 邮箱: [email protected]

自动构建与发布

本项目使用 GitHub Actions 进行自动构建和发布。每当推送带有版本标签（如 v1.0.0）的提交时，将触发自动构建流程：

1. 构建 Android 应用（使用 EAS Build）
2. 构建 Web 版本
3. 创建 GitHub Release 并附加构建文件

发布新版本

要发布新版本，请按照以下步骤操作：

1. 更新版本号（在 app.json 中）
2. 提交更改并推送到 GitHub
3. 创建新的版本标签并推送：

git tag v1.0.0
git push origin v1.0.0

4. GitHub Actions 将自动构建应用并创建 Release

配置 Expo 令牌

要使用 EAS Build，需要配置 Expo 令牌：

1. 在 Expo 开发者控制台 生成访问令牌
2. 在 GitHub 仓库中添加名为 EXPO_TOKEN 的 Secret（设置 > Secrets > Actions > New repository secret）

开发指南

1. 克隆仓库
2. 安装依赖

npm install

3. 启动开发服务器

npm start