Omi MCP服务器
](https://smithery.ai/server/@fourcolors/omi-mcp)
该项目提供了一个模型上下文协议（MCP）服务器，用于与Omi API交互。服务器提供读取对话和记忆以及创建新对话和记忆的工具。
设置
- 克隆存储库
- 安装依赖项
npm install - 创建一个
.env包含以下变量的文件：
API_KEY=your_api_key
APP_ID=your_app_id用法
通过Smithery安装
通过以下方式自动安装适用于Claude Desktop的Omi MCP服务器 史密瑟里:
npx -y @smithery/cli install @fourcolors/omi-mcp --client claude构建服务器
npm run build运行服务器
npm run start发展模式
对于热重载开发：
npm run dev测试服务器
包含一个简单的测试客户端，用于与MCP服务器交互。构建项目后，运行：
npm run test或者直接：
./test-mcp-client.js这将启动MCP服务器，并提供一个交互式菜单来测试可用工具。测试客户端使用默认的测试用户ID(test-user-123)对于所有操作。
清理和重建
要清理构建目录并从头开始重建，请执行以下操作：
npm run rebuild使用Claude和Cursor进行配置
克劳德配置
通过Anthropic控制台或API与Claude一起使用此MCP服务器：
- 在本地启动MCP服务器：
npm run start- 设置Claude对话时，配置MCP连接：
{
"mcp_config": {
"transports": [
{
"type": "stdio",
"executable": {
"path": "/path/to/your/omi-mcp-local/dist/index.js",
"args": []
}
}
]
}
}- 示例提示克劳德：
Please fetch the latest 5 conversations for user "user123" using the Omi API.- Claude将使用MCP执行
read_omi_conversations工具：
{
"id": "req-1",
"type": "request",
"method": "tools.read_omi_conversations",
"params": {
"user_id": "user123",
"limit": 5
}
}光标配置
要将此MCP服务器与Cursor一起使用，请执行以下操作：
- 在终端中启动MCP服务器：
npm run start- 在游标中，转到设置>扩展>MCP服务器
- 使用以下设置添加新的MCP服务器：
- 名称：奥米API - URL:sdio:/path/to/your/omi-mcp-local/dist/index.js - 启用服务器
- 现在，您可以直接在Cursor中使用Omi工具。例如：
@Omi API Please fetch memories for user "user123" and summarize them.- Cursor将与MCP服务器通信，以执行必要的API调用。
可用工具
MCP服务器提供以下工具：
read_omi_conversations
使用可选筛选器从Omi检索特定用户的对话。
参数：
user_id（string）：用于获取对话的用户IDlimit（number，可选）：要返回的最大对话数offset（number，可选）：分页时要跳过的对话数include_discarded（boolean，可选）：是否包含丢弃的对话statuses（字符串，可选）：逗号分隔的状态列表，用于按以下方式过滤对话
read_omi_memories
从Omi检索特定用户的内存。
参数：
user_id（string）：用于获取内存的用户IDlimit（number，可选）：要返回的最大内存数offset（number，可选）：分页时跳过的内存数量
create_omi_conversation
在Omi中为特定用户创建新对话。
参数：
text（string）：对话的全文内容user_id（string）：用于创建对话的用户IDtext_source（string）：文本内容的来源（选项：“audio_transcript”、“message”、“other_text”）started_at（字符串，可选）：对话/事件开始时（ISO 8601格式）finished_at（字符串，可选）：对话/事件结束时（ISO 8601格式）language（字符串，可选）：语言代码（默认值：“en”）geolocation（对象，可选）：对话的位置数据
- latitude （数字）：纬度坐标 - longitude （数字）：经度坐标
text_source_spec（string，可选）：关于源的附加规范
创建mi_memories
在Omi中为特定用户创建新的记忆。
参数：
user_id（string）：用于创建记忆的用户IDtext（string，可选）：从中提取记忆的文本内容memories（array，可选）：直接创建的显式内存对象数组
- content （string）：内存的内容 - tags （字符串数组，可选）：内存标签
text_source（字符串，可选）：文本内容的来源text_source_spec（string，可选）：关于源的附加规范
测试
要测试MCP服务器，您可以使用提供的测试客户端：
node test-mcp-client.js这将启动一个交互式测试客户端，允许您：
- 获取对话
- 获取回忆
- 创建对话
- 退出
测试客户端使用默认的测试用户ID(test-user-123)对于所有操作。
日志记录
MCP服务器包括内置的日志记录功能，可以写入控制台和日志文件。这对于调试和监视服务器活动非常有用。
日志文件位置
日志被写入 logs/mcp-server.log 在您的项目目录中。日志文件包括时间戳和以下详细信息：
- 服务器启动和关闭
- 所有API请求和响应
- 错误消息和堆栈跟踪
- API对Omi的调用
- 请求参数和响应数据
查看日志
您可以使用实时查看日志 tail 命令：
tail -f logs/mcp-server.log这将显示服务器处理请求并与Omi API交互时的实时更新。
日志格式
每个日志条目都遵循以下格式：
[2024-03-21T12:34:56.789Z] Log message here时间戳采用ISO 8601格式，便于关联事件和调试问题。