CKS MCP Server
Model Context Protocol server for Canonical Knowledge Structure.
cks-mcp is an MCP (Model Context Protocol) server that provides LLMs
with structured, verifiable knowledge operations through the CKS
ecosystem. It exposes four tools—validate_knowledge, serialize_knowledge,
explain_knowledge, and evolve_knowledge—each backed by the deterministic,
immutable semantics of cks-core and the operational management of cks-runtime.
Ecosystem
CKS Core is the semantic foundation of the CKS ecosystem. Other projects build upon it:
| Project | Description | Repository |
|---|---|---|
| cks-core | Canonical semantic engine | Deus-corp/cks-core |
| cks-runtime | Operational environment – sessions, transactions, persistence | Deus-corp/cks-runtime |
| cks-mcp | MCP server – exposes CKS to LLMs (this repository) | Deus-corp/cks-mcp |
Why cks-mcp?
LLMs generate plausible but unverified statements. cks-mcp gives them
a canonical knowledge backbone: every piece of information must be
explicitly structured, validated against formal constraints, and
traceable to its origin. This minimises hallucinations and makes AI‑
generated knowledge auditable.
Every tool call now creates a Runtime Session and Transaction, producing an immutable Version and collecting Diagnostics. This guarantees full auditability and reproducibility.
Installation
pip install cks-mcp
The server requires cks-runtime (which includes cks-core) as a dependency.
Quick Start
Launch the MCP server
cks-mcp
An MCP client (Claude Desktop, any MCP-compatible LLM) can then connect and call tools.
Interactive LLM client (Groq / DeepSeek / local)
export GROQ_API_KEY=your_key_here
python llm_client/cks_llm_client.py --provider groq
You can then type natural language requests; the LLM will automatically call the appropriate CKS tool.
Available Tools
| Tool | Description |
|---|---|
validate_knowledge |
Validate a Knowledge Structure and return diagnostics. |
serialize_knowledge |
Serialize a Knowledge Structure into canonical JSON. |
explain_knowledge |
Produce a semantic explanation of a Knowledge Structure. |
evolve_knowledge |
Apply Genesis/Decay operators to evolve a structure. |
Usage Example
{
"method": "tools/call",
"params": {
"name": "validate_knowledge",
"arguments": {
"json_data": "{\"objects\":[{\"identity\":{\"id\":\"obj-1\",\"type\":\"Definition\",\"name\":\"Test\"},\"structure\":{}}]}"
}
}
}
Response (with version and session information):
{
"result": {
"content": [
{
"type": "text",
"text": "{\"valid\": true, \"version_id\": \"...\", \"session_id\": \"...\", \"diagnostics\": [], ...}"
}
]
}
}
Testing
python -m pytest -v
16+ tests, all passing.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cks_mcp-0.4.0.tar.gz.
File metadata
- Download URL: cks_mcp-0.4.0.tar.gz
- Upload date:
- Size: 11.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bc143e810e9c1c39c3013df6661015a9827629e24657a845dd11b3638a374550
|
|
| MD5 |
59b73dee621cd06936e68963363e7e72
|
|
| BLAKE2b-256 |
8151454588ff3577382f513104203009d1a143e43a82d7378ba602de167c308d
|
File details
Details for the file cks_mcp-0.4.0-py3-none-any.whl.
File metadata
- Download URL: cks_mcp-0.4.0-py3-none-any.whl
- Upload date:
- Size: 9.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
34930566540880281a3daaa29b30b2511e8aba02875983b7d903d9f69347ce7a
|
|
| MD5 |
6fd7f1c292babef61edbb68546eef415
|
|
| BLAKE2b-256 |
85cc900a2749168fe0de8065ede063ac10a3034916d378710f9543bc86479c3a
|
