ManaWG

ManaWG MCP

为你的 AI 助手打造的合租公寓：通过 ManaWG 工具管理开支、余额、清洁轮值表、购物清单、 用品、公告栏、聊天和日历，适用于 Claude、ChatGPT、Cursor 以及所有其他 MCP 客户端。

连接 Agent · 工具 · 自托管 · 工作原理 · 参与贡献

ManaWG 是一款面向合租公寓的免费开源应用 （WG 是德语 Wohngemeinschaft 的缩写）。这个服务让助手像你在应用中那样管理合租生活：查看待办事项、登记你刚支付的款项、把牛奶加入清单， 并告诉你谁欠谁的钱。

连接 Agent

使用托管服务 https://mcp.manawg.com/mcp。客户端会打开浏览器，你登录 ManaWG 并授权助手即可。无需复制密钥，也无需安装任何东西。

客户端	添加方法
Claude Code	claude mcp add --transport http manawg https://mcp.manawg.com/mcp
Claude（网页、桌面端）	设置 → 连接器 → 添加自定义连接器，URL 为 https://mcp.manawg.com/mcp
ChatGPT	设置 → 应用和连接器 → 高级设置 → 开发者模式，然后使用 URL 和 OAuth 创建
Cursor、VS Code 和其他客户端	添加一个使用 URL https://mcp.manawg.com/mcp 的流式 HTTP 服务

还没有 ManaWG 账户？请在 app.manawg.com 创建账户和合租公寓，或者登录后让助手调用 wg_create。

可以询问的问题

• “这周合租公寓有哪些待办事项？”
• “我花 42.80 € 买了杂货，和所有人平摊，但不包括 Jonas。”
• “谁欠谁的钱？用最少的付款次数结清需要怎么做？”
• “把燕麦奶和洗洁精加入购物清单。”
• “我 12 号到 19 号不在，帮我从清洁轮值表中移除。”
• “为未结余额写一条友好的提醒，但不要发送。”

助手可以做什么

助手会在你所有的合租屋中代表你的账号行事，拥有与你在应用中相同的权限。

• 它可以读取你能看到的所有内容，创建和编辑开支、固定费用、购物清单项目、用品、家务、帖子、聊天消息、活动和缺席记录，并按照应用的方式结算欠款。
• 它不能删除合租屋、更改你的账号或登录信息，也不能转移资金。ManaWG 从不转移资金；结算只会记录你们彼此支付的金额。
• 托管服务会排除所有 16 个有破坏性的工具：删除开支、帖子或项目，更改合租屋或成员设置，发送提醒，以及提交导入内容。读取工具带有 readOnlyHint，因此客户端可以在每次其他调用前征求确认。
• **由你掌控。**你连接的每个助手都会列在应用的「设置 → 访问权限」中，你可以在那里断开任意一个助手。

完整的 74 个工具、13 个资源和 4 个提示词列表请见 docs/tools.md。

范畴	示例
概览	wg_overview、dashboard_get、activity_get、export_get
资金	expense_create、balances_get、settlement_preview、cash_payment_record
固定费用	recurring_list、recurring_create、recurring_advance
购物和用品	shopping_add、shopping_set_bought、inventory_consume
清洁轮值	chores_list、chore_complete、absence_create
公告栏和聊天	note_create、note_comment、chat_send、chat_unread
日历	events_list、event_create、event_update
提示词	daily_brief、shopping_run、payment_reminder、settlement_plan

工作原理

sequenceDiagram
    autonumber
    participant C as MCP client
    participant M as mcp.manawg.com
    participant S as Supabase Auth
    participant A as app.manawg.com
    C->>M: POST /mcp
    M-->>C: 401 + protected resource metadata
    C->>S: register client, start sign-in (PKCE)
    S->>A: consent page
    A-->>S: user signs in and allows
    S-->>C: access token
    C->>M: POST /mcp with bearer token
    M->>M: verify token against the JWKS
    M->>A: same call to the app API, with the token
    A-->>M: data, checked against your membership
    M-->>C: tool result

该服务是一个 OAuth 2.1 资源服务，符合 MCP 授权规范中的描述。Supabase Auth 已用于应用登录，因此也充当授权服务。MCP 服务不存储任何内容：它会检查每个令牌并转发令牌，而应用会执行与手机端相同的成员资格检查。

每个工具只调用应用 API 中的一个路由。资金以整数分为单位，每次写入都会携带幂等键，因此重试请求不会重复记账；可能与室友操作发生竞争的写入会失败，而不会覆盖数据（chore_occurrence_changed、shopping_item_changed）。错误会以固定代码返回，例如 ManaWG request failed: splits_sum_mismatch，绝不会包含上游文本或凭据。

自托管

在自己的机器上运行它，可以通过 stdio 为本地 Agent 提供服务，通过 HTTP 在 API 密钥保护下提供服务，或在自己的 ManaWG 实例前部署为自己的 OAuth 服务。

git clone https://github.com/Abuarchiv/manawg-mcp.git && cd manawg-mcp
pnpm install && pnpm build
mkdir -p ~/.config/manawg-mcp && cp .env.example ~/.config/manawg-mcp/env
chmod 600 ~/.config/manawg-mcp/env        # then fill in your instance and account
claude mcp add manawg --env-file ~/.config/manawg-mcp/env -- node "$(pwd)/dist/index.js"

也可以使用 Docker：ghcr.io/abuarchiv/manawg-mcp（linux/amd64、linux/arm64）。

自托管指南介绍了两种身份验证模式、所有环境变量、HTTP 传输、Docker，以及在 mcp.manawg.com 后面的 Vercel 部署。

开发

你需要 Node.js 22 和 pnpm 9。运行测试、lint 和类型检查无需凭据。

pnpm lint        # Biome
pnpm typecheck   # tsc --noEmit
pnpm test        # Vitest: flows against a stateful stub app, API surface, OAuth
pnpm build       # compile to dist/
pnpm smoke       # stdio handshake against dist/
pnpm inspector   # MCP Inspector against dist/index.js
pnpm live-check  # read-only probes against a real instance (credentials required)

测试会运行真实的服务、客户端和会话代码，并针对一个会强制执行应用规则的桩应用（Origin、Cookie、幂等键、乐观锁、严格请求体）进行测试；API 表面检查会确保每个工具都映射到应用实际存在的路由。

贡献

欢迎提交问题和拉取请求。请先阅读 CONTRIBUTING.md 和 Code of Conduct。有关应用本身的问题请提交至应用代码仓库。请私下报告安全问题，参见 SECURITY.md。更改记录见 CHANGELOG.md。

许可证

采用 Apache License 2.0，与 ManaWG 应用相同。该许可证不授予使用 ManaWG 名称或其徽标的权利。