factstore
A fact store for AI agents, on Postgres: registered attributes, every write citing its evidence.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
factstoreclaude mcp add factstore -e 'FACTSTORE_DSN=<your factstore_dsn>' -e 'FACTSTORE_EXCISE_DSN=<your factstore_excise_dsn>' -- uvx factstore==0.1.0 mcp
{
"mcpServers": {
"factstore": {
"command": "uvx",
"args": [
"factstore==0.1.0",
"mcp"
],
"env": {
"FACTSTORE_DSN": "<your factstore_dsn>",
"FACTSTORE_EXCISE_DSN": "<your factstore_excise_dsn>"
}
}
}
}
متغيرات البيئة
FACTSTORE_DSNإلزامي سري The credential `factstore actor STORE NAME` prints: a Postgres connection string for one actor of one store.FACTSTORE_EXCISE_DSNسري An excision credential (`factstore actor --excise`). Only then is the excise tool listed.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
factstore
A fact store for AI agents, on Postgres. Agents record what a company's systems and documents say as facts: a value for a registered attribute, in a transaction stamped with who wrote it and the document it came from. Nothing is overwritten, so the store can say what it knew on any date.
Skills that ship with it index a company's systems from their exports, and read documents and mail into facts. They leave people's personal details in the source. MIT-licensed.
Install
pip install factstore
In Claude Code, the plugin brings the MCP server and the skills:
/plugin marketplace add Victor-EU/factstore
/plugin install factstore@factstore
factstore/README.md walks through Postgres, a first store and connecting an agent.
What's here
factstore/ | The kernel, the MCP server, the Python SDK and the CLI |
packages/ | Vocabulary packages: core, and ecom-ops and ecom-index for an online brand |
factstore-skills/ | The catalogue, ontology and ingestion skills |
evals/ | What it was tested on: a synthetic brand, and five public datasets from real companies |
factstore-design.md | The design, and what testing changed in it |
factstore-build-plan.md | The milestones, and where each stands |
Status
0.1.0, alpha. The kernel's code held unchanged through every test, up to 3.2 million facts in one store. The skills passed every round on public data: product lists, a million order lines, a marketplace's duplicate customers, 100 suppliers' forms and a trader's mailbox. No company has run it on its own data yet.
الأسئلة الشائعة
ما هو factstore؟
A fact store for AI agents, on Postgres: registered attributes, every write citing its evidence.
كيف أثبّت factstore؟
يعمل على جهازك. في Claude Code: claude mcp add factstore -e 'FACTSTORE_DSN=<your factstore_dsn>' -e 'FACTSTORE_EXCISE_DSN=<your factstore_excise_dsn>' -- uvx factstore==0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج factstore إلى مفتاح API؟
نعم. يتطلب FACTSTORE_DSN, FACTSTORE_EXCISE_DSN، وتضبطها في إعداداته.
هل factstore مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون factstore؟
ينشره Victor-EU. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.