ontology
py-ontology-server-starter
オントロジー知識サーバースターター — FastAPIセマンティックレイヤー + Apache Jena Fusekiトリプルストア、利用者はRESTとMCPの両方。
Palantir式オブジェクト中心オントロジー(Object Type / Property / Link Type)をコードで宣言し、 保存・照会はW3C標準(RDF / SPARQL 1.1)で処理する。アプリケーションコードはSPARQL標準のみ を使用するため、ストアをGraphDBなどに交換してもアプリはそのまま動作する。
┌─ 소비자 ──────────────────────────────┐
│ AI 에이전트(MCP) 앱·사람(REST) │
└──────────┬───────────────┬───────────┘
│ │
mcp_server.py api/rest.py ← 이중 어댑터
└───────┬───────┘
ontology/ + store/ ← 코어: 온톨로지 정의 + SPARQL 클라이언트
│
Apache Jena Fuseki (docker) ← 저장·SPARQL·추론
▲
ingest/ 파이프라인 ← 지식원 → RDF 변환·적재クイックスタート
# 1. 트리플스토어 기동
docker compose up -d fuseki # http://localhost:3030 (admin / admin)
# 2. 앱 설치
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
# 3. 샘플 데이터 적재 (CSV → RDF → Fuseki)
python -m ontology_server.ingest.example_csv data/sample/organizations.csv \
--object-type organization --push
# 4. REST 서버 기동
uvicorn ontology_server.main:app --reload
# → http://localhost:8000/docs
curl localhost:8000/objects/organizationRelated MCP server: mcp-ubergraph-query
MCPアダプター(AIエージェント用)
stdioトランスポートで実行される。Claude Codeプロジェクトの.mcp.json:
{
"mcpServers": {
"ontology": {
"command": "/절대경로/.venv/bin/python",
"args": ["-m", "ontology_server.mcp_server"]
}
}
}提供ツール: list_object_types(スキーマ把握) · search_objects(タイプ別インスタンス照会) · sparql_query(読み取り専用の直接照会)。
自分のドメインに置き換える
src/ontology_server/ontology/sample.pyをドメインオントロジーに置き換える — Object Type・Link Typeの宣言だけを変更すればREST・MCP・クエリビルダーも追従する。src/ontology_server/ingest/に知識源ごとの収集モジュールを追加する(example_csv.py参照)。外部連携・標準準拠が必要な場合は、名前空間を実際のURIスキームに定め、OWLスキーマ文書も併せて管理する。
テスト
pytest # 단위 테스트 (Fuseki 불필요)
RUN_INTEGRATION=1 pytest # Fuseki 기동 상태에서 통합 테스트 포함構成
パス | 役割 |
| Object/Link Type定義フレームワーク (Palantir式) |
| サンプルオントロジー — プロジェクトで置き換えるファイル |
| SPARQL 1.1クライアント (ストア交換可能なポイント) |
| RESTアダプター |
| MCPアダプター |
| 知識源 → RDF収集パイプライン |
| Fuseki起動 |
ライセンス
MIT
Available Tools
3 toolslist_object_typesA
온톨로지에 정의된 Object Type·Link Type 전체를 반환한다. 질의 전에 먼저 호출해 스키마를 파악할 것.
Inputs: no named parameters. Returns: result
search_objectsB
지정한 Object Type의 인스턴스를 조회한다. object_type은 list_object_types의 api_name.
Inputs: object_type (required), limit. Returns: result
sparql_queryA
읽기 전용 SPARQL(SELECT/ASK/CONSTRUCT/DESCRIBE)을 직접 실행한다. 복잡한 관계 질의용.
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a distinct purpose: schema discovery, instance search, and raw SPARQL querying. There is no overlap between them.
Tool names follow a consistent verb_noun pattern (list_object_types, search_objects, sparql_query). sparql_query is slightly less parallel because it uses a noun rather than a verb, but it is still clear and predictable.
Three tools is a minimal but reasonable set for an ontology server: schema listing, instance search, and flexible SPARQL access. It is on the thin side but not inadequate.
The surface covers schema discovery, instance lookup, and arbitrary read-only queries, which covers most ontology use cases. Missing write operations are likely intentional for a read-only server, so the gap is minor.
Related MCP Connectors
Query your own knowledge graph from any MCP client. The graph lives in a database you own.
Knowledge graph for AI agents. Query concepts, walk edges, get advisories.
Read-only search of your Sortio knowledge graph (files and entities) for Claude and ChatGPT.
Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that provides read-only access to Ontotext GraphDB, enabling LLMs to explore RDF graphs and execute SPARQL queries.29 npm17GPL 3.0
- AlicenseAqualityDmaintenanceEnables AI assistants to query the Ubergraph biomedical ontology SPARQL endpoint with tools for custom SPARQL queries, term lookup, search, and hierarchy traversal.4MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with ontologies through the Ontology Access Kit, providing ontology querying and management capabilities.5MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to query, modify, and reason over OWL/TTL/RDF ontology files using natural language, without needing SPARQL or OWL syntax.146MIT