Founders Os

Founders OS

面向初创企业和小型企业创始人的开源 MCP 服务。

Founders OS 为你提供完整的业务上下文——CRM、项目、任务、财务、动态、记忆和操作手册——可通过 Claude、Cursor 或任何兼容 MCP 的 AI 客户端访问。只需连接一次，即可接入整个业务。

由 OurThinkTank 构建。营销网站：foundersmcp.com。

刚开始接触 AI 工具，或要把它交给刚接触的人使用？请从先读这里开始——这里用通俗易懂的语言介绍 FoundersOS 是什么、不是什么，AI 助手能做什么、不能做什么，以及如何养成让它们保持诚实的习惯。

包含内容

模块	工具数	说明
CRM	13	客户、联系人、互动记录、销售渠道仪表板
任务	12	支持实体关联、AI 分配、依赖关系和进度备注的任务
项目	5	以项目标签为基础的一等项目记录，并汇总相关任务
操作手册	11	可复用的编排模板，可分派任务并触发外部 MCP 操作
标签	4	共享标签注册表，支持宽松验证和自动注册
财务	14	复式记账、损益表、多公司、按用户设置访问控制
动态	13	RSS/Atom/JSON 阅读器、简报、书签、置顶内容
记忆	5	语义记忆，支持个人和组织范围、pgvector、去重及元数据筛选
工作界面	6	跨领域读取：会话开始、实体卡片、每周回顾、停滞事项列表、会话检查点、项目历史
成员	4	组织成员目录、所有者指定
审计 + 恢复	2	完整审计日志；软删除恢复
诊断	5	Ping、版本、使用指南、功能探索器、演示

12 个模块共计 94 个工具。

快速开始

你需要一个 Supabase 项目、一个嵌入 API 密钥（默认使用 OpenAI），以及一个支持 MCP 的 AI 客户端。

1. 设置 Supabase

创建一个 Supabase 项目，然后在 SQL Editor 中运行 supabase/setup.sql。这个文件可从零开始设置完整的架构——扩展（vector、uuid-ossp、pg_trgm）、所有表、索引、RLS 策略、函数、视图、维护任务，以及与 Supabase 兼容所需的 Data API 授权；这些授权用于 Supabase 对 2026-05-30 当天或之后创建的项目取消自动默认权限后的配置。你也可以使用 foundersmcp.com/setup 上的向导，它会根据你的服务提供商设置匹配的嵌入维度，并生成相同的 SQL——如果你不使用默认维度，建议使用此向导。

2. 连接 AI 客户端

Founders OS MCP 服务通过 npx 运行。所有客户端——Claude Desktop、Cowork、Cursor、Continue.dev、Zed 或任何符合规范的 MCP 客户端——都使用相同的配置。

最快捷的方式是使用 foundersmcp.com/setup 上的向导：输入你的 Supabase 和嵌入凭据，即可生成可供复制或下载的完整配置。你的凭据不会离开浏览器。你也可以手动粘贴下面的配置块。

将其放入客户端的 mcp.json 中（在 Claude Desktop 中，这是配置里的 MCP 服务部分）：

{
  "mcpServers": {
    "founders-os": {
      "command": "npx",
      "args": ["-y", "@ourthinktank/founders-os@latest"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SECRET_KEY": "sb_secret_...",
        "FOUNDERS_OS_COMPANY_ID": "your-company",
        "FOUNDERS_OS_USER_ID": "your-name",
        "FOUNDERS_OS_TIMEZONE": "America/Los_Angeles",
        "EMBEDDING_PROVIDER": "openai",
        "EMBEDDING_MODEL": "text-embedding-3-small",
        "EMBEDDING_DIM": "1536",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

完整列表和服务提供商选项请参阅环境变量。

3. 试用

What can you do?                                  -> show_capabilities
Catch me up                                       -> get_session_start
Add Acme Corp as a new prospect                   -> add_customer
Log a call with Sarah at Acme - discussed pricing -> log_interaction
Create a task to send the proposal by Friday      -> create_task + link_task
What's stuck or overdue?                          -> get_stuck_list
Show me everything about Acme Corp                -> get_entity_card
Remember for the org: targeting SMB fintech in Q3 -> memory_store
Show me OTT's P&L for Q1                          -> get_pl_report
Run the customer-onboarding playbook for Acme     -> run_playbook
Give me my weekly retro for LinkedIn              -> get_weekly_retro
Let's checkpoint - wrap up this session           -> checkpoint
What's happened on founders-os lately?            -> get_project_history

---

CRM（13 个工具）

用于管理客户组织及其联系人。客户是组织，联系人是人员——二者始终是分开的记录，因此你可以在客户之间转移联系人，而不会丢失历史记录。

客户： add_customer、get_customer、update_customer、remove_customer、search_customers、list_customers

联系人： add_contact、update_contact、remove_contact、search_contacts

互动记录： log_interaction、list_interactions

仪表板： get_dashboard

销售管道阶段： prospect -> lead -> opportunity -> customer -> renewal（以及 churned、inactive）。

---

Tasks（12 个工具）

统一的任务管理，支持组织和个人范围、实体关联、AI 分配、任务依赖、进度备注，以及任务到记忆的桥接。

create_task、get_task、update_task、complete_task、remove_task、list_tasks、link_task、unlink_task、list_entity_tasks、add_task_note、assign_task、get_task_summary

范围： org（团队可见，默认）和 personal（仅创建者可见）。

AI 分配： 将 @claude 或 @gpt 设为受分配者。get_task_summary 会显示专用的 AI 工作队列。list_tasks(assigned_to='@claude') 可筛选分配给 AI 的工作。

依赖关系： 在任务上设置 blocked_by_task_id。完成阻塞任务后，响应中会显示 unblocked_tasks。

任务到记忆的桥接： 完成任务时，设置 store_as_memory=true，即可将完成备注保存为组织范围的记忆条目。

实体关联： 任务可以通过 task_links 关联表关联到客户、联系人、互动记录、交易、项目、操作手册、记忆或任何其他实体类型。可在创建时关联，也可之后使用 link_task 关联。

---

Projects（5 个工具）

项目是以项目标签（例如 #acme-rebuild）为锚点的一级记录。get_project 会返回项目卡片，其中包含状态、关联标签、按状态分组的近期任务，以及标记到该项目的所有客户。

create_project、get_project、update_project、remove_project、list_projects

list_projects 还会标记注册表中所有以 # 开头但尚无项目记录的标签，确保注册表与项目目录保持同步。

---

Playbooks（11 个工具）

命名的可复用编排模板。操作手册只需定义一次，即可针对客户（或其他对象）运行，以启动完整项目：它会创建 Founders OS 原生任务，并在存在已连接的 MCP 工具时触发外部操作，例如创建 GitHub 仓库、向 Slack 发布消息或安排日历事件。如果连接器不可用，该步骤会顺利回退为带有 [manual] 标记的任务，确保操作手册仍可使用。

create_playbook、get_playbook、update_playbook、remove_playbook、list_playbooks、add_playbook_step、update_playbook_step、remove_playbook_step、run_playbook、get_playbook_run、list_playbook_runs

步骤类型： native_task（Founders OS 任务）或 external_action（MCP 工具调用）。外部步骤包含 connector、action 和带占位符的 params 对象。

占位符： {{customer.name}}、{{customer.slug}}、{{playbook.start_date}}、{{playbook.start_date+Nd}}、{{contact.primary.name}}、{{memory:key}}，均在运行时解析。

运行日志： get_playbook_run 返回完整的执行日志；list_playbook_runs 显示每个操作手册的运行历史。

---

标签（4 个工具）

共享标签注册表，采用软验证。标签仅供参考：无法识别的标签会发出警告，但不会阻止操作；新标签会在首次使用时自动注册。

list_tags、create_tag、rename_tag、remove_tag

约定： 项目使用 #project-name，人员使用 @person，元状态使用 !state（例如 !needs-review）。bug 或 release 等简单类别词无需添加前缀。

验证检查： 检查是否存在与已有标签相似的拼写错误、识别已知联系人（提示使用 @）、识别已知客户（提示关联实体），以及识别状态词（提示使用 !）。

---

财务（14 个工具）

简单的复式记账账本，按 FOUNDERS_OS_COMPANY_ID 隔离，并采用按用户设置的访问控制，因此可以只向特定队友开放公司账簿。

add_transaction、list_transactions、remove_transaction、add_category、list_categories、remove_category、add_account、list_accounts、remove_account、transfer_between_accounts、get_pl_report、get_financial_summary、get_financial_access、set_financial_access

多公司： 为每个实例设置不同的 FOUNDERS_OS_COMPANY_ID，以保持账簿相互隔离。

访问控制： set_financial_access 可授予或撤销成员使用某家公司的财务工具的权限。get_financial_access 会报告当前授权情况。默认情况下，FOUNDERS_OS_COMPANY_ID 对应公司的所有者拥有访问权限；其他人则无法访问，除非明确授予权限。

---

订阅源（13 个工具）

内置订阅源阅读器（RSS、Atom、JSON Feed），采用 Postgres 存储。可订阅、生成简报、搜索、收藏和置顶。

订阅： subscribe_feed、unsubscribe_feed、list_feeds、refresh_feeds、import_starter_feeds、pin_feed、unpin_feed

条目： get_feed_items、read_feed_item、get_feed_briefing

书签： bookmark_item、remove_bookmark、list_bookmarks

类别： tech、startups、business、finance、product、design、engineering、ai、crypto、science、news、personal、other。

---

记忆（5 个工具）

由 pgvector 支持的语义记忆，支持个人和组织范围、近似重复检测、元数据筛选和分页。

memory_store、memory_recall、memory_update、memory_forget、memory_summarize_and_store

范围：

• org - 对指向同一 Supabase 项目的所有团队成员可见
• personal - 仅对 FOUNDERS_OS_USER_ID 匹配的用户可见

memory_recall 的筛选条件： min_score、source_tool、created_after、created_before、offset、limit、project、scope。

去重： memory_store 和 memory_summarize_and_store 会使用余弦相似度 >= 0.92 检查是否已有记忆，并提示冲突及强制存储或跳过的选项。

嵌入提供商（通过 EMBEDDING_PROVIDER 设置）：

提供商	默认模型	维度	凭据
openai（默认）	text-embedding-3-small	1536	OPENAI_API_KEY
bedrock	amazon.nova-2-multimodal-embeddings-v1:0	1024	AWS 凭据链
ollama	nomic-embed-text	768	OLLAMA_BASE_URL

运行 002_memory_schema.sql 前，请设置与模型匹配的 EMBEDDING_DIM。维度是固定的——之后更换提供商需要对记忆表重新生成嵌入。

---

界面（6 个工具）

跨领域读取视图，将任务、CRM、财务和动态中的数据整合为可直接呈现的仪表板，供 AI Agent 使用。

工具	返回内容
get_session_start	概览仪表板：任务信号、AI 队列、财务概况、CRM 活动、动态未读数、建议操作、首次运行标记，以及四层呈现规范。每次会话开始时调用。
get_entity_card	一次调用即可全面了解任意实体（客户、联系人、交易、项目），包括未完成任务、近期互动和关联记录。
get_weekly_retro	按标签分组的已完成任务回顾，附带完成备注。可整理成适合发布到 LinkedIn 的草稿。
get_stuck_list	汇总需要分流处理的卡住、长期未更新和逾期任务，并提供未更新天数和建议操作。
checkpoint	与 get_session_start 配对使用的会话结束步骤。返回有序的收尾流程（总结、将仓库变更记录为提交链接、保存记录、提出后续任务、编写交接文档）、需要调用的确切记忆工具，以及上一次检查点，以便延续未完成事项。基于记忆运行——不新增实体，也不进行迁移。
get_project_history	按时间倒序排列的项目检查点时间线，是语义记忆检索的“按顺序发生了什么”补充视图。传入 kind: 'all' 可获取所有记忆，而不仅是检查点。

---

成员（4 个工具）

组织成员目录。将 FOUNDERS_OS_USER_ID 标识映射到显示名称，标记公司所有者，并支持添加或移除成员。

add_member、list_members、remove_member、set_member_owner

FOUNDERS_OS_COMPANY_ID 的所有者默认拥有财务访问权限；其他成员可通过 set_financial_access 获得访问权限。

---

审计与恢复（2 个工具）

get_audit_log 返回涵盖所有领域的结构化审计记录（创建、更新、删除、恢复、财务访问权限变更、剧本运行）。

restore_item 撤销任何软删除记录的删除操作，将记录恢复到先前状态。使用审计日志查找原始删除事件和要恢复的实体 ID。

---

诊断与元信息（5 个工具）

工具	说明
ping	连通性测试。如果有更新的程序包版本，会附带更新通知。
get_version	当前运行的程序包版本、呈现规范版本，以及最新发布到 npm 的版本。
get_usage_guide	按需提供模块、约定和常见工作流参考。
show_capabilities	以直观易懂的方式概述各模块，并为每个模块提供示例提示词。
list_demos	列出或运行捆绑的交互式演示（欢迎导览、冲突解决、运行我的一周等）。

---

呈现规范

包含呈现内容的工具会提供一个 render 字段，其中设有四层阶梯，让 AI 客户端选择其支持的最直观输出形式：可视化原语工具（artifact/widget/canvas）、内嵌富文本输出（HTML/SVG/JSX）、Markdown 表格，然后是文字说明。该规范通过三个渠道传递，按注意力强度排序：

1. MCP 注册时的服务端 instructions 字段——连接时加载。适用于所有符合规范的 MCP 客户端。
2. get_session_start.rendering_contract——会话概览中提供完整的阶梯说明。适用于所有客户端。
3. 每次响应中的 rendering_contract 提醒——简短且独立完整的版本，可作为冷启动安全网。

规范的权威来源位于 packages/mcp-server/src/contract.ts，因此所有 MCP 客户端都能通过这些渠道获得丰富的呈现效果，无需插件。（计划在后续版本中推出一个 Claude 插件，在系统提示词中镜像此规范，以便在较长会话中更严格地遵循；该插件不包含在此版本中。）当前的 contract_version 为 4；如果版本不匹配，get_session_start 和 get_version 会显示 contract_version_warning。

首次运行引导

数据库为空时，工具会在响应中附上引导提示。get_session_start 会检测是否为全新安装，并建议进行引导式体验：添加第一个客户、创建第一个任务，以及选择性地设置财务账户。这样可以让体验保持对话式，而不是一次性列出全部 92 个工具。

如需了解特定功能的引导演示，请让 AI“运行欢迎演示”或“展示冲突解决引导流程”——list_demos 会返回打包的交互式脚本。

---

环境变量

# Supabase (required)
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SECRET_KEY=sb_secret_...

# Identity - set distinct values per teammate so personal memory scopes work
FOUNDERS_OS_USER_ID=your-name            # defaults to "default"
FOUNDERS_OS_COMPANY_ID=your-company      # defaults to "default"
FOUNDERS_OS_TIMEZONE=America/Los_Angeles # used by date-aware tools and YTD math

# Embedding provider for memory tools
EMBEDDING_PROVIDER=openai                # openai | bedrock | ollama
EMBEDDING_MODEL=text-embedding-3-small   # provider default used if omitted
EMBEDDING_DIM=1536                       # MUST match the vector() size in 002_memory_schema.sql

# OpenAI (required if EMBEDDING_PROVIDER=openai)
OPENAI_API_KEY=sk-...

# Bedrock (uses AWS credential chain - no key needed on AWS with IAM role)
# AWS_DEFAULT_REGION=us-east-1
# AWS_ACCESS_KEY_ID=...
# AWS_SECRET_ACCESS_KEY=...

# Ollama (required if EMBEDDING_PROVIDER=ollama)
# OLLAMA_BASE_URL=http://localhost:11434

---

开发

# Clone
git clone https://github.com/ourthinktank/founders-os.git
cd founders-os

# Install
npm install

# Build
npm run build

# Watch
npm run dev

项目结构

founders-os/
├── packages/
│   ├── mcp-server/                  # @ourthinktank/founders-os npm package
│   │   ├── src/
│   │   │   ├── index.ts             # Entry point (stdio transport)
│   │   │   ├── supabase.ts          # Database client
│   │   │   ├── contract.ts          # Canonical rendering contract
│   │   │   └── tools/
│   │   │       ├── crm/             # Customers, contacts, interactions, dashboard
│   │   │       ├── tasks/           # Task management
│   │   │       ├── projects/        # Project records
│   │   │       ├── playbooks/       # Reusable orchestration templates
│   │   │       ├── tags/            # Shared tag registry
│   │   │       ├── financial/       # Ledger + access control
│   │   │       ├── rss/             # Feed reader
│   │   │       ├── memory/          # Semantic memory
│   │   │       ├── surfaces/        # Cross-domain reads
│   │   │       ├── members/         # Org directory
│   │   │       ├── audit.ts         # Audit log
│   │   │       ├── restore.ts       # Soft-delete recovery
│   │   │       ├── diagnostic.ts    # Ping + version
│   │   │       ├── meta.ts          # Usage guide + capabilities + demos
│   │   │       ├── first-run.ts     # Empty-database hints
│   │   │       ├── dates.ts         # Date/timezone helpers
│   │   │       └── permissions.ts   # Financial access checks
│   │   └── demos/                   # Interactive walkthrough scripts
├── integrations/
│   └── setup-page/                  # Config wizard hosted at foundersmcp.com/setup
├── supabase/
│   ├── setup.sql                    # Complete schema for fresh installs (run once)
│   └── migrations/                  # Future schema changes (currently empty)
├── docs/                            # Specs and design docs
└── README.md

本地安装以进行测试

完成构建后，将 MCP 客户端指向本地入口，而不是 npx：

{
  "mcpServers": {
    "founders-os": {
      "command": "node",
      "args": ["/absolute/path/to/founders-os/packages/mcp-server/dist/index.js"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SECRET_KEY": "sb_secret_...",
        "FOUNDERS_OS_USER_ID": "your-name",
        "FOUNDERS_OS_COMPANY_ID": "your-company",
        "EMBEDDING_PROVIDER": "openai",
        "EMBEDDING_DIM": "1536",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

---

贡献

Founders OS 基于 MIT 许可证开源。目前暂不接受外部贡献——这一安排即将改变。与此同时，欢迎并非常鼓励提交问题报告：请在 GitHub 上提交。有关如何提交优质报告，请参阅 CONTRIBUTING.md 和我们的 Code of Conduct。安全问题应通过 SECURITY.md 处理，而不是公开提交。

许可证

MIT——请参阅 LICENSE。