Somiya

Name: Somiya
Author: somiya.app

本地服务

somiya.app生产力06 天前更新

代码仓库访问官网

关于 Somiya

Somiya 是本地 MCP 服务，可让 AI 助手读取家庭日历、任务和购物清单。它能提交待确认的新增建议，但不能直接更改数据。

主要功能

01读取近期活动和到期任务
02按时间范围搜索日历活动
03列出家庭任务和购物项目
04提交任务和购物项目建议
05根据令牌权限提供工具

适用场景

01询问家庭本周的安排
02查看未完成任务和购物清单
03提交待在应用中确认的项目建议

MCP 相关

本地 MCP 服务向助手提供 Somiya 日历、任务和购物清单工具，具体取决于令牌权限。新增建议须在应用中确认后才会生效；不提供直接修改功能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "app-somiya": {
      "command": "npx",
      "args": [
        "-y",
        "somiya-mcp"
      ],
      "env": {
        "SOMIYA_TOKEN": "<SOMIYA_TOKEN>"
      }
    }
  }
}

启动命令npx -y somiya-mcp

需要配置的环境变量

SOMIYA_TOKEN密钥Token created in the Somiya app under Settings → AI access

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmsomiya-mcp0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

somiya-mcp

Somiya 的 MCP 服务——让你自己的 AI 助手访问家庭日历和任务。

由你的 AI 提议。由你确认。

该服务运行在你的设备上。你的助手与它通信，它再与 Somiya API 通信；Somiya 的服务器永远不会看到对话内容。助手可以读取你能看到的内容，也可以建议一项任务或购物清单商品——但建议只是在应用中等待你点击确认的一行文字。在你确认之前，不会有任何内容写入家庭数据。

快速开始

在 Somiya 应用中：Settings → AI access → Create token。复制令牌（只会显示一次）。
将以下内容添加到 MCP 客户端的配置中：

{
  "mcpServers": {
    "somiya": {
      "command": "npx",
      "args": ["-y", "somiya-mcp"],
      "env": { "SOMIYA_TOKEN": "smcp_..." }
    }
  }
}

重启客户端，然后询问它 “这周家里有什么安排？”

无需安装应用即可试用

一个虚构家庭——Riveras 一家的只读令牌是公开的，因此你无需安装任何东西，就能先看看助手可以获取哪些内容：

claude mcp add somiya-demo -e SOMIYA_TOKEN=smcp_NDh8cy3ETXdhz37s-_cr8XgctTUYh3QgUMDIDqTy1zI -- npx -y somiya-mcp

也可以将它放入上面的配置中。它可以读取他们的日历、任务和购物清单，但不能提出任何建议。所有试用者共用这一个令牌，因此在繁忙时段，它可能会有一分钟左右返回“请求过多”。

工具

工具	所需范围	返回内容
`somiya_whats_next`	—	接下来 7 天的事件和到期／逾期任务
`somiya_get_family`	—	家庭成员姓名和角色
`somiya_whoami`	—	此令牌的标签、范围、角色和过期时间
`somiya_search_events`	`read:calendar`	两个时间戳之间的事件
`somiya_list_tasks`	`read:tasks`	未完成的家庭任务
`somiya_list_shopping`	`read:tasks`	购物清单及其商品
`somiya_suggest_task`	`suggest:changes`	提交一项任务，供你在应用中确认。不会创建任何内容
`somiya_suggest_shopping_item`	`suggest:changes`	提交一件商品，供你在应用中确认。不会创建任何内容

只会公布令牌范围允许使用的工具——助手永远不会看到自己无法使用的工具。未提供令牌时启动服务，服务会列出所有工具，每个工具都会说明如何获取令牌。创建令牌时可选择范围；读取范围默认启用，suggest:changes 默认关闭。

配置

变量	默认值
`SOMIYA_TOKEN`	—	必填。在应用中创建。
`SOMIYA_API_URL`	`https://api.somiya.app`	仅在可自托管或使用预发布环境时覆盖。

隐私

**Somiya 永远不会看到你的 AI 对话。**此进程是唯一同时与双方通信的部分，并且运行在你的设备上。
**你的 AI 服务提供商确实可以看到你发送给它的内容。**你粘贴到助手中的内容受该服务提供商的条款约束——这是你的选择和约定，不是 Somiya 能代你做出的决定。
可随时撤销，就在创建令牌的同一页面操作。令牌从下一次调用起即停止工作。
令牌在 90 天后过期。
Somiya 会统计每种工具的调用次数，用于容量规划。这些计数器只记录工具名称和日期——不记录用户、家庭、参数或结果。

为什么它不能自行写入

读取不可信内容（转发的邮件、传单、网页）的助手可能会受这些内容的操控。给它一个“删除任务”工具，提示注入就不再只是个新鲜事，而会造成破坏。因此，边界就是产品本身：每项更改都要由人在应用中操作。

建议会以一行文字和两个按钮的形式出现。确认后，会运行与你亲自点击时相同的代码，经过相同的权限检查，并留下相同的审计记录；忽略建议则不会留下任何痕迹；未处理的建议会在一天后丢弃。确认不是一项设置——没有“始终允许”选项，因为“始终允许”开关恰恰会把注入的指令变成实际更改。

编辑和删除甚至不会作为建议提供。能够建议添加内容的助手，最坏也只是浪费你的时间。而能够建议删除内容的助手，则会让你每次都只能点一下来批准损失。

噪声也受到限制，因为你不再阅读的确认提示就等同于没有提示：每个客户端最多有 10 条未处理的建议，每批建议只发送一条通知，而不是每条都发送通知，并且会遵守你设置的免打扰时段。

开发

pnpm install
pnpm build

在 Somiya monorepo 中，请改用 pnpm install --ignore-workspace。这一点很重要：此软件包特意放在 monorepo 的 pnpm 工作区之外。该仓库会将依赖提升到 node_modules（shamefully-hoist=true），而将 HTTP 服务的依赖树并入工作区，会让移动应用的解析器能够访问本不该出现在其范围内的软件包。

需要 Node 20+（使用全局 fetch）。