xiaozhi MCP server

MCP示例项目|MCP示例项目

一个强大的界面，用于通过远程控制、计算、电子邮件操作、知识搜索等扩展人工智能功能。

一个强大的接口，用于通过远程控制、计算、邮件操作、知识搜索等方式扩展AI能力。

Overview | 概述

MCP（模型上下文协议）是一种允许服务器公开可由语言模型调用的工具的协议。工具使模型能够与外部系统交互，例如查询数据库、调用API或执行计算。每个工具都由一个名称唯一标识，并包含描述其模式的元数据。

MCP（模型上下文协议）是一个允许服务器向语言模型暴露可调用工具的协议。这些工具使模型能够与外部系统交互，例如查询数据库、调用API或执行计算。每个工具都由一个唯一的名称标识，并包含描述其模式的元数据。

Features | 特性

• 🔌 Bidirectional communication between AI and external tools | AI与外部工具之间的双向通信
• 🔄 Automatic reconnection with exponential backoff | 具有指数退避的自动重连机制
• 📊 实时数据流|实时数据流传输
• 🛠️ Easy-to-use tool creation interface | 简单易用的工具创建接口
• 🔒 Secure WebSocket communication | 安全的WebSocket通信

Quick Start | 快速开始

1. Install dependencies | 安装依赖:

pip install -r requirements.txt

1. 设置环境变量|设置环境变量:

export MCP_ENDPOINT=

1. 运行计算器示例|运行计算器示例:

python mcp_pipe.py calculator.py

食材服务使用说明

食材服务提供食材记录和管理功能，支持以下操作：

添加食材

{
  "method": "tools/call",
  "params": {
    "name": "manage_ingredients",
    "arguments": {
      "action": "add",
      "data": {
        "name": "番茄",
        "quantity": 4,
        "unit": "个",
        "category": "蔬菜"
      }
    }
  }
}

更新食材

{
  "method": "tools/call",
  "params": {
    "name": "manage_ingredients",
    "arguments": {
      "action": "update",
      "data": {
        "id": 1,
        "quantity": 5
      }
    }
  }
}

删除食材

{
  "method": "tools/call",
  "params": {
    "name": "manage_ingredients",
    "arguments": {
      "action": "delete",
      "data": {
        "id": 1
      }
    }
  }
}

查看食材列表

{
  "method": "tools/call",
  "params": {
    "name": "get_ingredients_list"
  }
}

运行食材服务

python ingredient_service.py

Project Structure | 项目结构

• mcp_pipe.py: Main communication pipe that handles WebSocket connections and process management | 处理WebSocket连接和进程管理的主通信管道
• calculator.py: Example MCP tool implementation for mathematical calculations | 用于数学计算的MCP工具示例实现
• requirements.txt: Project dependencies | 项目依赖

Creating Your Own MCP Tools | 创建自己的MCP工具

Here's a simple example of creating an MCP tool | 以下是一个创建MCP工具的简单示例:

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("YourToolName")

@mcp.tool()
def your_tool(parameter: str) -> dict:
    """Tool description here"""
    # Your implementation
    return {"success": True, "result": result}

if __name__ == "__main__":
    mcp.run(transport="stdio")

Use Cases | 使用场景

• Mathematical calculations | 数学计算
• Email operations | 邮件操作
• Knowledge base search | 知识库搜索
• Remote device control | 远程设备控制
• Data processing | 数据处理
• Custom tool integration | 自定义工具集成

Requirements | 环境要求

• Python 3.7+
• websockets>=11.0.3
• python dotenv>=1.0.0
• mcp>=1.8.1
• 媒染剂>=2.11.4

Contributing | 贡献指南

欢迎投稿！请随时提交拉取请求。

欢迎贡献代码！请随时提交Pull Request。

License | 许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

本项目采用MIT许可证 - 详情请查看LICENSE文件。

致谢|致谢

• Thanks to all contributors who have helped shape this project | 感谢所有帮助塑造这个项目的贡献者
• Inspired by the need for extensible AI capabilities | 灵感来源于对可扩展AI能力的需求