Feason Context

Feason Context SDK

面向 Feason Context REST API 的类型化、无依赖 TypeScript 和 Python 客户端，以及其 OpenAPI 3.1 契约。

Feason Context 提供以来源为依据的基督教研究资料，包含精确段落、来源信息、稳定引用、明确列出的传统覆盖范围，以及清晰说明的覆盖边界。应用程序自行决定如何使用返回的证据。

包含内容

• typescript/ — @feason/context
• python/ — feason-context
• openapi/feason-context-openapi.yaml — 公开 REST 契约
• contract.json — 用于生成两个客户端的版本化端点元数据
• server.json — 托管远程服务的官方 MCP Registry 元数据
• DIRECTORY_LISTING.md — 可复用、明确说明边界的 MCP 目录文案

托管服务仍位于 https://www.feason.com。这些客户端不包含 Feason 语料库、生产凭据、用户数据、检索引擎或服务端实现。令牌仅在运行时接受，绝不会持久化。

TypeScript

import { FeasonContextClient } from "@feason/context";

const client = new FeasonContextClient({ token: process.env.FEASON_CONTEXT_TOKEN! });
const packet = await client.evidencePacket({ question: "How did early Christians describe grace?" });
console.log(packet);

Python

import os
from feason_context import FeasonContextClient

client = FeasonContextClient(os.environ["FEASON_CONTEXT_TOKEN"])
packet = client.evidence_packet("How did early Christians describe grace?")
print(packet)

开发

node scripts/generate-clients.mjs --check
npm --prefix typescript install
npm --prefix typescript run build
npm --prefix typescript test
python3 -m unittest discover -s python -p 'test_*.py'

分发

SDK 软件包名称已在其清单中预留，但在验证其注册记录之前，不会宣称可公开安装。发布前检查和验证流程请参阅 PUBLISHING.md。

托管 MCP 服务由单独的 server.json 描述。目录描述应保留 Feason 的证据层边界；请参阅 DIRECTORY_LISTING.md。

安全

请勿将 API 令牌放入源代码、示例、议题或测试固件中。有关私密漏洞报告，请参阅 SECURITY.md。

许可证

MIT。请参阅 LICENSE。