factsets (Joshua Auchincloss)

事实集

人工智能代理的自我维护知识库，通过 模型上下文协议（MCP）.管理 事实 （原子知识）， 资源 （缓存的外部内容）， 技能 （程序性降价），以及 执行日志 （命令历史）使用SQLite。

特性

• 持久上下文 -知识在会议中得以保留
• 自我维护 -带有刷新指令的状态检测
• 基于标签的组织 -灵活的分类和检索
• 技能文档 -用于程序知识的Markdown文件
• 用户选项 -可配置的输出样式和代理行为
• MCP协议 -AI工具/提示定义的标准界面

安装

npm install --global factsets
pnpm install --global factsets
bun install --global factsets

快速开始

作为MCP服务器

使用以下命令添加到MCP客户端配置（Claude Desktop、GitHub Copilot、Cursor等） bunx, npx 或 pnpm dlx 因此：

{
  "mcpServers": {
    "factsets": {
      "command": "bunx",
      "args": ["factsets", "mcp-server"]
    }
  }
}

或者直接运行：

bunx factsets mcp-server

首次设置

将Factsets添加到MCP客户端后，运行安装提示将其集成到您的项目中：

在支持的IDE中：类型 /mcp.factsets.setup 在聊天中运行引导设置

在其他客户中：呼叫 get_setup_guide 工具或使用 setup 提示

安装指南将：

• 分析你的项目结构并建立基线事实
• 为您的AI客户端配置技能目录
• 创建或更新 AGENTS.md 使用Factsets指令
• 通过Factsets集成迁移任何现有技能
• 将密钥配置文件注册为资源

这种一次性设置可确保代理在未来的每次交互中都有完整的上下文。

CLI命令

# Start MCP server (default command - auto-watches skill files and seeds starter content)
bunx factsets [--database-url 
] [--client ]

# Explicit mcp-server command (same as above)
bunx factsets mcp-server [--database-url 
] [--client ]

# Start without file watching
bunx factsets --no-watch-skills

# Start without seeding starter content
bunx factsets --no-seed

# Run file watcher standalone
bunx factsets watch-files [--database-url 
]

# Run background maintenance worker
bunx factsets worker [--database-url 
]

# Export database to JSON
bunx factsets dump backup.json

# Restore database from JSON
bunx factsets restore backup.json

这 --client 标志配置技能文件的存储位置（例如。， github-copilot -> .github/prompts/skills/).如果您想更改客户/技能目录，请通过您的代理进行更改，该代理将为您迁移技能。

看 配置指南 对于所有选项。

核心概念

MCP工具

事实

资源

技能

执行日志

标签

配置

用户选项

维护

背景与指南

MCP提示

文档

• 配置指南 -CLI标志、客户端设置和技能目录
• 设计参考 -API完整文档
• 概念 -哲学和设计原理
• 代理工作流 -代理如何使用Factset

发展

# Run tests
bun test

# Run full e2e (tests + build + dry run)
bun e2e

# Build distribution
bun dist

# Format code
bun format

# Lint
bun lint

# Generate database migrations
bun migrations

# Inspect MCP server with inspector
bun inspect