tekneh 0.1.0__tar.gz

tekneh-0.1.0/.gitignore

@@ -0,0 +1,23 @@
+# Nested sibling checkouts (own remotes)
+/tekneh_web/
+/tekneh_research/
+/meta_artpaper_paper/
+/mid/
+# Site deploy wrapper (lives with tekneh_web; not part of the PyPI package)
+/deploy.sh
+# Local export accidents
+/tekneh-public/
+/tekneh-pkg/
+# sync.sh copies (source of truth: tekneh_research)
+/src/tekneh_mcp/data/
+/src/tekneh_mcp/query.py
+# Tooling / build
+.venv/
+dist/
+*.egg-info/
+__pycache__/
+*.pyc
+.env
+.env.*
+!.env.example
+*.PNG

tekneh-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.5
+Name: tekneh
+Version: 0.1.0
+Summary: SIGGRAPH and SIGGRAPH Asia art-paper technē corpus — what papers state about making media art, and what they leave unstated
+Project-URL: Homepage, https://tekneh.com
+Project-URL: Repository, https://github.com/joonhyungbae/tekneh
+Project-URL: Documentation, https://tekneh.com/about.html
+Author-email: Joonhyung Bae <jh.bae@kaist.ac.kr>
+License: CC-BY-4.0
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.2.0
+Description-Content-Type: text/markdown
+
+# Tekneh MCP
+
+An MCP server for asking what SIGGRAPH and SIGGRAPH Asia art papers **wrote — and did not write — about implementation**.
+
+It ships a corpus of 229 work papers (2009–2026) fully coded on 11 implementation fields.
+Data is bundled in the package, so **no server and no network are required.** CSV is 566KB; it starts instantly.
+
+## Install — any MCP client
+
+MCP is an open protocol. **This server is not tied to any one vendor’s product.** It speaks standard JSON-RPC over stdio, so any MCP-capable client can attach. Most use the block below as-is.
+
+```json
+{ "mcpServers": { "tekneh": { "command": "uvx", "args": ["tekneh"] } } }
+```
+
+Public source and PyPI metadata Repository: **`https://github.com/joonhyungbae/tekneh`**.
+Author: Joonhyung Bae \<jh.bae@kaist.ac.kr\>. You do not need to put PyPI/GitHub in the paper body.
+Export and history cleanup: `EXPORT.md`.
+| Client | Where to put it | Differences |
+|---|---|---|
+| Claude Code | `claude mcp add tekneh -- uvx tekneh` | or `.mcp.json` |
+| Claude Desktop | `claude_desktop_config.json` | block above as-is |
+| Cursor | `~/.cursor/mcp.json` · `.cursor/mcp.json` | block above as-is |
+| Cline · Continue · Windsurf | each extension’s MCP settings | block above as-is |
+| VS Code (Copilot agent) | `.vscode/mcp.json` | top-level key is **`servers`**; entry needs `"type": "stdio"` |
+| Zed | `settings.json` | top-level key is **`context_servers`** |
+| Codex CLI | `~/.codex/config.toml` | **TOML** — see below |
+
+```toml
+# ~/.codex/config.toml
+[mcp_servers.tekneh]
+command = "uvx"
+args = ["tekneh"]
+```
+
+Config schemas drift a little by client. If it does not attach, check only the key names in that tool’s latest MCP docs — `command`/`args` are the same everywhere.
+
+### Transport
+
+Default is **stdio**; all settings above use it. For remote or web clients:
+
+```bash
+tekneh --http --port 6230      # streamable-http, http://127.0.0.1:6230/mcp
+tekneh --sse                   # legacy SSE
+```
+
+```json
+{ "mcpServers": { "tekneh": { "url": "http://127.0.0.1:6230/mcp" } } }
+```
+
+From inside the repo, run `python -m tekneh_mcp`. Data location: `TEKNEH_DATA=/path` or `--data`.
+
+### If the tool does not use MCP
+
+The same queries are available via the MCP tools above (or `uvx tekneh` with an MCP client).
+Return shape matches the tool results. Codebook role labels such as `런타임` (runtime) are stored as-is in the CSVs.
+
+## Five tools
+
+| Tool | What it does |
+|---|---|
+| `corpus_info` | Corpus boundary · population · human-confirmed values · citation rules. **Call this first** |
+| `field_stats` | How often a field is stated. Denominator and absent count together |
+| `search_works` | Search works. **Filter with `absent` for “what the paper did not write”** |
+| `works_using` | Works that used a given tool. `role` separates runtime / production / learning |
+| `cite` | Source quote (20 words) · section locus · doi |
+
+## Four reading rules
+
+This corpus is valuable because **you can count what is missing**. Reading it differs from the usual.
+
+1. **`absent` is a property of the document, not the work.** Not “this work used no power,” but
+   **“not stated in the paper (whether it existed is unknown).”** Use the return’s `phrasing` and `reading_note` as written.
+2. **If `small_cell` is true, do not generalize.** Denominator under 30. Sound has 27 papers, robotics 30, so
+   “sound is done with Max/MSP” (4/27) is false. Always report the denominator.
+3. **State `boundary` in the answer.** SIGGRAPH and SIGGRAPH Asia art papers 2009–2026 only.
+   No Ars Electronica, NIME, ISEA, exhibition catalogs, or artist websites. The population is **papers, not works**.
+4. **If `use_this` is present, use that value, not `rate`.** The machine overcounts prose lists and third-party URLs as stated.
+
+| Field | Machine | Value to use |
+|---|---:|---|
+| Venue requirements | 25.9% | **20.5%** (16.2–24.8) |
+| Reproducibility (public) | 10.5% | **6.1%** — a **lower bound**, not a point estimate. Write “6–14%” |
+
+## What this corpus does well / poorly
+
+**Does well.** What it was made with — tools named in 79% of papers; 457 unique kinds with
+runtime / production / learning roles. Form × tool join reaches 80%.
+
+**Does poorly.** How to remake it. Venue conditions are stated in 20.5%; public release in only 6–14%.
+It cannot help with circuit debugging — papers do not record wiring faults.
+Turning `absent` into **questions to ask the artist** is the proper use of this data.
+
+## Citation
+
+Annotations are CC BY 4.0. **Source quotes are capped at 20 words per field**; the server enforces that bound.
+For more, follow `doi` to the original paper — ACM DL blocks scripted access, so do not crawl.
+
+## Building from the repository
+
+Shipped wheels already include `query.py` and the CSV tables under `src/tekneh_mcp/`.
+Those files are produced before `uv build` and are not committed.
+
+```bash
+bash sync.sh     # maintainers: refresh bundled data, then:
+uv build
+UV_PUBLISH_TOKEN=pypi-... bash publish.sh --upload
+```
+
+Or use GitHub Actions Trusted Publishing so Actions uploads without a token — often requires a public repo.
+
+See `EXPORT.md` for packaging notes.

tekneh-0.1.0/README.md

@@ -0,0 +1,112 @@
+# Tekneh MCP
+
+An MCP server for asking what SIGGRAPH and SIGGRAPH Asia art papers **wrote — and did not write — about implementation**.
+
+It ships a corpus of 229 work papers (2009–2026) fully coded on 11 implementation fields.
+Data is bundled in the package, so **no server and no network are required.** CSV is 566KB; it starts instantly.
+
+## Install — any MCP client
+
+MCP is an open protocol. **This server is not tied to any one vendor’s product.** It speaks standard JSON-RPC over stdio, so any MCP-capable client can attach. Most use the block below as-is.
+
+```json
+{ "mcpServers": { "tekneh": { "command": "uvx", "args": ["tekneh"] } } }
+```
+
+Public source and PyPI metadata Repository: **`https://github.com/joonhyungbae/tekneh`**.
+Author: Joonhyung Bae \<jh.bae@kaist.ac.kr\>. You do not need to put PyPI/GitHub in the paper body.
+Export and history cleanup: `EXPORT.md`.
+| Client | Where to put it | Differences |
+|---|---|---|
+| Claude Code | `claude mcp add tekneh -- uvx tekneh` | or `.mcp.json` |
+| Claude Desktop | `claude_desktop_config.json` | block above as-is |
+| Cursor | `~/.cursor/mcp.json` · `.cursor/mcp.json` | block above as-is |
+| Cline · Continue · Windsurf | each extension’s MCP settings | block above as-is |
+| VS Code (Copilot agent) | `.vscode/mcp.json` | top-level key is **`servers`**; entry needs `"type": "stdio"` |
+| Zed | `settings.json` | top-level key is **`context_servers`** |
+| Codex CLI | `~/.codex/config.toml` | **TOML** — see below |
+
+```toml
+# ~/.codex/config.toml
+[mcp_servers.tekneh]
+command = "uvx"
+args = ["tekneh"]
+```
+
+Config schemas drift a little by client. If it does not attach, check only the key names in that tool’s latest MCP docs — `command`/`args` are the same everywhere.
+
+### Transport
+
+Default is **stdio**; all settings above use it. For remote or web clients:
+
+```bash
+tekneh --http --port 6230      # streamable-http, http://127.0.0.1:6230/mcp
+tekneh --sse                   # legacy SSE
+```
+
+```json
+{ "mcpServers": { "tekneh": { "url": "http://127.0.0.1:6230/mcp" } } }
+```
+
+From inside the repo, run `python -m tekneh_mcp`. Data location: `TEKNEH_DATA=/path` or `--data`.
+
+### If the tool does not use MCP
+
+The same queries are available via the MCP tools above (or `uvx tekneh` with an MCP client).
+Return shape matches the tool results. Codebook role labels such as `런타임` (runtime) are stored as-is in the CSVs.
+
+## Five tools
+
+| Tool | What it does |
+|---|---|
+| `corpus_info` | Corpus boundary · population · human-confirmed values · citation rules. **Call this first** |
+| `field_stats` | How often a field is stated. Denominator and absent count together |
+| `search_works` | Search works. **Filter with `absent` for “what the paper did not write”** |
+| `works_using` | Works that used a given tool. `role` separates runtime / production / learning |
+| `cite` | Source quote (20 words) · section locus · doi |
+
+## Four reading rules
+
+This corpus is valuable because **you can count what is missing**. Reading it differs from the usual.
+
+1. **`absent` is a property of the document, not the work.** Not “this work used no power,” but
+   **“not stated in the paper (whether it existed is unknown).”** Use the return’s `phrasing` and `reading_note` as written.
+2. **If `small_cell` is true, do not generalize.** Denominator under 30. Sound has 27 papers, robotics 30, so
+   “sound is done with Max/MSP” (4/27) is false. Always report the denominator.
+3. **State `boundary` in the answer.** SIGGRAPH and SIGGRAPH Asia art papers 2009–2026 only.
+   No Ars Electronica, NIME, ISEA, exhibition catalogs, or artist websites. The population is **papers, not works**.
+4. **If `use_this` is present, use that value, not `rate`.** The machine overcounts prose lists and third-party URLs as stated.
+
+| Field | Machine | Value to use |
+|---|---:|---|
+| Venue requirements | 25.9% | **20.5%** (16.2–24.8) |
+| Reproducibility (public) | 10.5% | **6.1%** — a **lower bound**, not a point estimate. Write “6–14%” |
+
+## What this corpus does well / poorly
+
+**Does well.** What it was made with — tools named in 79% of papers; 457 unique kinds with
+runtime / production / learning roles. Form × tool join reaches 80%.
+
+**Does poorly.** How to remake it. Venue conditions are stated in 20.5%; public release in only 6–14%.
+It cannot help with circuit debugging — papers do not record wiring faults.
+Turning `absent` into **questions to ask the artist** is the proper use of this data.
+
+## Citation
+
+Annotations are CC BY 4.0. **Source quotes are capped at 20 words per field**; the server enforces that bound.
+For more, follow `doi` to the original paper — ACM DL blocks scripted access, so do not crawl.
+
+## Building from the repository
+
+Shipped wheels already include `query.py` and the CSV tables under `src/tekneh_mcp/`.
+Those files are produced before `uv build` and are not committed.
+
+```bash
+bash sync.sh     # maintainers: refresh bundled data, then:
+uv build
+UV_PUBLISH_TOKEN=pypi-... bash publish.sh --upload
+```
+
+Or use GitHub Actions Trusted Publishing so Actions uploads without a token — often requires a public repo.
+
+See `EXPORT.md` for packaging notes.

tekneh-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[project]
+name = "tekneh"
+version = "0.1.0"
+description = "SIGGRAPH and SIGGRAPH Asia art-paper technē corpus — what papers state about making media art, and what they leave unstated"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "CC-BY-4.0" }
+authors = [
+  { name = "Joonhyung Bae", email = "jh.bae@kaist.ac.kr" },
+]
+dependencies = ["mcp>=1.2.0"]
+
+[project.urls]
+Homepage = "https://tekneh.com"
+Repository = "https://github.com/joonhyungbae/tekneh"
+Documentation = "https://tekneh.com/about.html"
+
+[project.scripts]
+tekneh = "tekneh_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+# data/·query.py are sync.sh copies and gitignored. ignore-vcs so the wheel still
+# ships them. only-include keeps nested research/site checkouts out of the sdist.
+[tool.hatch.build]
+ignore-vcs = true
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+  "src/tekneh_mcp",
+  "README.md",
+  "pyproject.toml",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tekneh_mcp"]

tekneh-0.1.0/src/tekneh_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""Tekneh MCP — 아트 페이퍼 구현 코퍼스 질의 서버."""
+__version__ = "0.1.0"

tekneh-0.1.0/src/tekneh_mcp/__main__.py

@@ -0,0 +1,2 @@
+from .server import main
+main()