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 を参照してください。