Jidoseal MCP

jidoseal-mcp

Verifique uma pasta de notas Markdown em relação ao Open Knowledge Format (OKF) v0.2 — de dentro do Claude Code, Claude Desktop, Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI, Zed, Cline, Continue, JetBrains AI Assistant ou um modelo local, na sua própria máquina.

Escolha uma pasta, escaneie-a. jidoseal-mcp é um servidor local Model Context Protocol que lê o frontmatter YAML de cada arquivo *.md em uma pasta, informa qual nível a base de conhecimento atinge (Bronze / Prata / Ouro) e lista — por arquivo — os campos de frontmatter exatos que faltam para o próximo nível. Nada sai da sua máquina: nenhum arquivo, nenhum nome de arquivo, nenhum conteúdo de arquivo.

pip install jidoseal-mcp
claude mcp add jidoseal -- jidoseal-mcp     # Claude Code; every other tool is below

Então pergunte ao seu assistente: "Escaneie ~/notes com JidoSeal e me diga o que falta para Prata."

Independente. OKF é uma especificação aberta do Google Cloud. JidoSeal não é afiliado, patrocinado ou endossado pelo Google ou ISO. A ISO não nomeia campos: os campos Prata e Ouro abaixo são a forma da JidoSeal de evidenciar as cláusulas ISO, e um certificado JidoSeal não é uma certificação ISO.

O que ele verifica

O escaneamento é determinístico — presença de campos de frontmatter preenchidos, sem chamadas de modelo, sem pontuação por opinião. Um campo conta apenas se tiver conteúdo real (title: sem nada depois não ganha nada).

O nível de um corpus é o nível do seu arquivo mais fraco. A cobertura é a parcela de arquivos que atinge cada nível. A referência completa de campos — aliases aceitos, o que conta como "preenchido", o que é excluído — está em docs/tiers.md.

Um arquivo mínimo de nível Ouro:

---
type: policy
title: Leave policy
description: How leave accrues and how to request it.
timestamp: 2026-09-01
owner: dept:people-ops
status: stable
review_policy: yearly
reviewed_at: 2026-09-01
next_review_at: 2027-09-01
---

Exemplos trabalhados para cada nível, e uma pasta mista, estão em examples/tiers/.

Ferramentas

Exemplo de resultado jidoseal_scan para examples/tiers/mixed (três arquivos, um Ouro, um Bronze, um sem frontmatter):

{
  "corpus": { "file_count": 3, "tier": "none",
              "coverage": { "bronze": 66.7, "silver": 33.3, "gold": 33.3 } },
  "score": 44,
  "certified_eligible": false,
  "files": [
    { "name": "expenses.md", "tier": "bronze",
      "missing": { "silver": [ { "field": "description", "fix": "AUTO" },
                               { "field": "timestamp",   "fix": "AUTO" },
                               { "field": "owner",       "fix": "NEEDS-CLIENT" } ] } }
    // …
  ]
}

frontmatter_ok: false em um arquivo significa que seu bloco de frontmatter existe, mas não é analisável; nenhuma escrita de campo pode fechar suas lacunas até que seja corrigido manualmente.

Instale e conecte à sua ferramenta

Requer Python 3.9+. pip install jidoseal-mcp também instala jidoseal (o mecanismo de escaneamento e CLI) e coloca um comando jidoseal-mcp no seu PATH. Sem conta e sem chave de API. O escaneamento em si não precisa de rede — ele roda igualmente offline.

Cada ferramenta abaixo inicia o mesmo comando local, jidoseal-mcp, via stdio. Apenas o lugar onde você o escreve difere.

claude mcp add jidoseal -- jidoseal-mcp

{ "mcpServers": { "jidoseal": { "command": "jidoseal-mcp" } } }

{ "mcpServers": { "jidoseal": { "command": "jidoseal-mcp", "args": [] } } }

{ "mcpServers": { "jidoseal": { "type": "stdio", "command": "jidoseal-mcp", "args": [] } } }

{ "servers": { "jidoseal": { "type": "stdio", "command": "jidoseal-mcp" } } }

codex mcp add jidoseal -- jidoseal-mcp

[mcp_servers.jidoseal]
command = "jidoseal-mcp"

gemini mcp add -s user jidoseal jidoseal-mcp

{ "mcpServers": { "jidoseal": { "command": "jidoseal-mcp" } } }

{ "context_servers": { "jidoseal": { "command": "jidoseal-mcp", "args": [], "env": {} } } }

{ "mcpServers": { "jidoseal": { "type": "stdio", "command": "jidoseal-mcp", "args": [], "disabled": false } } }

name: JidoSeal
version: 0.0.1
schema: v1
mcpServers:
  - name: jidoseal
    type: stdio
    command: jidoseal-mcp

{ "mcpServers": { "jidoseal": { "command": "jidoseal-mcp", "args": [] } } }

{ "mcpServers": { "jidoseal": { "command": "jidoseal-mcp", "args": [], "env": {} } } }

pipx install jidoseal && jidoseal --root ~/notes

Se o seu host usar um Python diferente daquele em que você instalou, aponte-o para o módulo: "command": "/path/to/python", "args": ["-m", "jidoseal_mcp"].

Verifique a conexão manualmente, sem nenhum host:

printf '%s\n' \
 '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"x","version":"0"}}}' \
 '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
 | jidoseal-mcp

Você deve ver um resultado initialize nomeando jidoseal, e então as três ferramentas.

Execute em CI

A CLI escreve .jidoseal/manifest.json; algumas linhas a transformam em um portão. Veja docs/ci.md para um fluxo de trabalho do GitHub Actions que falha a build quando qualquer arquivo fica abaixo de Prata.

O que sai da sua máquina

Um escaneamento: nada. Nem os arquivos, nem seus nomes, nem seus conteúdos. Isso é uma propriedade do grafo de importação, não uma promessa sobre quais ramos executam: jidoseal_mcp.py, scan_result.py e offer.py não importam socket, nem urllib, nem cliente HTTP, e nada do que eles puxam também. checkout_client.py é o único módulo que pode alcançar a rede, e é importado apenas dentro do manipulador de checkout.

Uma compra, apenas se você escolher uma: a empresa, nome e email que você digitou, o nível, uma pontuação de 0–100, a raiz Merkle do corpus, o id do escaneamento local e qual preço Bronze se aplica. Sem conteúdos de arquivo, sem nomes de arquivo, sem hashes por arquivo, sem caminhos. A raiz Merkle é um digest unidirecional.

Verifique você mesmo:

strace -f -o /tmp/trace.txt -e trace=network jidoseal-mcp < your-jsonrpc-input   # no network syscalls during a scan
bwrap --unshare-net --dev-bind / / jidoseal-mcp < your-jsonrpc-input             # the scan works with no network at all

O escaneamento escreve seus próprios registros — manifest.json e um progress.ndjson anexado — sob <folder>/.jidoseal/ e em nenhum outro lugar. Ele nunca modifica suas notas.

Certificação opcional

O escaneamento é gratuito e ilimitado, e também as correções. Se você quiser um certificado datado para a nota que sua pasta alcançou, vinculado à raiz Merkle do seu corpus, com uma página de verificação pública e uma listagem no registro público, isso é uma etapa paga em jidoseal.com; os preços atuais são publicados lá, um preço fixo por nota, independentemente de quantos arquivos. Uma pessoa na JidoSeal assina com base na nota, na pontuação e nessa impressão digital apenas, nunca a partir dos conteúdos dos seus arquivos.

Links

• Site: https://jidoseal.com
• Registro público de bases de conhecimento certificadas: https://jidoseal.com/registry
• PyPI: jidoseal-mcp · jidoseal
• Registro MCP: com.jidoseal/jidoseal-mcp
• Especificação OKF (Google Cloud, Apache-2.0): https://github.com/GoogleCloudPlatform/open-knowledge-format
• Contato: support@jidoseal.com

Sobre este repositório

Este repositório contém o código-fonte do pacote jidoseal-mcp: um servidor MCP implementado apenas na biblioteca padrão do Python (sem SDK MCP), falando JSON-RPC 2.0 via stdio. Ele depende do pacote separadamente publicado jidoseal para o mecanismo de escaneamento, que não faz parte deste repositório. Issues são bem-vindas; não há suíte de testes neste repositório, então inclua as versões de jidoseal-mcp e jidoseal e a menor pasta que reproduza um problema.

Licença

Apache-2.0 para o código neste repositório — veja LICENSE. O mecanismo jidoseal do qual depende é distribuído separadamente sob seus próprios termos.