语音助手协议服务器

LAURA语音助手系统的模型上下文协议(MCP)服务器,提供语音输入、文本转语音、会话管理和多代理集成功能。

  • by TwinPeaksTownie
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 LAURA-agent/LAURA-MCP-Server

使用说明

LAURA MCP服务器-干净部署

用于LAURA语音辅助系统的综合模型上下文协议(MCP)服务器。

项目结构

LAURA-MCP-Clean/
├── core/                 # Core MCP server components
├── TTS/                  # Text-to-Speech server (ElevenLabs)
├── voice_injection/      # Voice input and injection system
├── bridge/              # Mac hub bridge for iOS connectivity
├── memory/              # Memory management and persistence
├── agents/              # Specialized agent modules
├── hydration/           # Hydration tracking system
├── email_system/        # Email management and integration
├── llm_integrations/    # LLM adapter modules
├── config/              # Configuration files
├── scripts/             # Launch and management scripts
├── logs/                # System logs
├── chat_logs/           # Conversation history
├── audio_cache/         # TTS audio cache
└── working_memory/      # Session-specific context

快速开始

1.设置虚拟环境

python3 -m venv venv
source venv/bin/activate
pip install -r config/requirements.txt

2.配置API密钥

创建 core/secret.py 使用API密钥:

ANTHROPIC_API_KEY = "your-key"
OPENAI_API_KEY = "your-key"
ELEVENLABS_API_KEY = "your-key"

3.发射服务

启动MCP服务器

./scripts/start_mcp_server.sh

启动TTS服务器

./TTS/start_tts_server.sh

开始语音输入

./voice_injection/start_voice_input.sh

启动Mac Hub Bridge(适用于iOS)

python bridge/mac_http_bridge.py

或者一次启动所有内容:

./scripts/launch_laura_full.sh

核心组件

MCP服务器(core/mcp_server.py)

  • 使用FastMCP实现主服务器
  • 处理设备注册和会话管理
  • 协调所有子系统

TTS服务器(TTS/tts_server.py)

  • ElevenLabs集成文本到语音
  • 音频流和缓存
  • 个人语音支持

语音注入(voice_injection/quick_voice.py)

  • 捕获语音输入
  • 注入克劳德代码或终端
  • 一键通和唤醒词支持

Mac Hub桥(bridge/mac_http_bridge.py)

  • iOS设备的HTTP网桥
  • 将MCP协议转换为REST API
  • 管理设备会话

存储系统(memory/)

  • 持续的对话上下文
  • 主题映射和时间线
  • 活动会话的工作记忆

代理系统(agents/)

  • 不同任务的专业代理
  • 日历、联系人、电子邮件代理
  • Claude代码集成

配置

环境变量

  • ANTHROPIC_API_KEY:Claude API访问
  • OPENAI_API_KEY:GPT模型访问
  • ELEVENLABS_API_KEY:TTS服务

端口配置

  • MCP服务器:8765
  • TTS服务器:9090
  • Mac Hub桥接器:8080

依赖项

看 config/requirements.txt 查看完整列表。关键依赖关系:

  • fastmcp
  • 人类
  • openai
  • 十一个实验室
  • 快速
  • 优维康
  • websockets

系统要求

  • macOS 10.15+
  • Python 3.10+
  • 最低4GB RAM
  • API调用的网络访问

守护程序设置(可选)

对于自动启动:

./scripts/setup_mcp_daemon.sh

故障排除

检查服务状态

curl http://localhost:8765/health

查看日志

tail -f logs/mcp_server.log

重置内存

rm -rf working_memory/*

许可证

私人项目-保留所有权利

支持

有关问题或疑问,请查看 docs/ 文件夹。