
frshaka/sankhya-schema-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Servidor MCP (모델 컨텍스트 프로토콜) que conecta o Claude Code e/ou o Codex CLI ao banco do Sankhya ERP, Allowindo explorar tabelas, campos, índices, relacionamentos e executar 쿼리 SQL ...
개요
Servidor MCP (모델 컨텍스트 프로토콜) que conecta o Claude Code e/ou o Codex CLI ao banco do Sankhya ERP, Allowindo explorar tabelas, campos, índices, relacionamentos e executar 쿼리 SQL diretamente durante uma conversa. Suporta os distribuídos pela Sankhya no ambiente de desenvolvimento : A escolha é feita por SANKHYA DB TYPE no .env — veja Configuração do banco. O comentário de coluna do catálogo vem na base Sankhya (0 de 69.782 colunas medidas). semântica mora no dicionário da aplicação, e é de lá que a tool tira a descrição (TDDCAM) e o domínio dos campos enumerados (TDDOPC): Sem isso, quem escreve 쿼리 precisa adivinhar o 문학은 WHERE합니다. Em TGFCAB.TIPMOV, V (Venda) e P (Pedido de venda) são — trocar um pelo outro devolve 문서 oo errado sem levantar nenhum erro de SQL. E o mesmo nome de campo tem domínio diferente em tabelas diferentes: TIPMOV 존재하는 em 17 tabelas, com 드 2 a 24 opções cada.
개요(AI 번역)
Servidor MCP (모델 컨텍스트 프로토콜) que conecta o Claude Code e/ou o Codex CLI ao banco do Sankhya ERP, Allowindo explorar tabelas, campos, índices, relacionamentos e executar 쿼리 SQL diretamente durante uma conversa.
Suporta osdois bancos distribuídos pela Sankhya no ambiente de desenvolvimento:
| 반코 | 드라이버 | 심플 도커 | Porta | Endereçamento |
|---|---|---|---|---|
| 오라클(벼랑) | oracledb em modothick (Instant client 21c, compatível com Oracle 11.2+) |
sankhyaimages/skdev-oracle:1.1.0 |
1521 | SID [[T2] |
| SQL Server | pymssql (wheel com FreeTDS embutido — não exige driver de sistema operacional) |
[[T4] | 1433 | 데이터베이스 [T5] |
escolha é feita por SANKHYA_DB_TYPE] no .env - veja Configuração do banco.
Funcionalidades의
| 도구 | 오 큐 faz |
|---|---|
describe_table |
Colunas, tipos, nullable, descrição em português e todos os valores aceitos 캠프스 멘토스를 할 수 있습니다 |
search_tables |
Busca tabelas por nome parcial (ex: TGF], TSIUSU]), **com descrição de cada uma ** |
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Sankhya Schema MCP
Servidor MCP (Model Context Protocol) que conecta o Claude Code e/ou o Codex CLI ao banco do Sankhya ERP, permitindo explorar tabelas, campos, índices, relacionamentos e executar queries SQL diretamente durante uma conversa.
Suporta os dois bancos distribuídos pela Sankhya no ambiente de desenvolvimento:
| Banco | Driver | Imagem Docker | Porta | Endereçamento |
|---|---|---|---|---|
| Oracle (padrão) | oracledb em modo thick (Instant Client 21c, compatível com Oracle 11.2+) |
sankhyaimages/skdev-oracle:1.1.0 |
1521 | SID XE |
| SQL Server | pymssql (wheel com FreeTDS embutido — não exige driver de sistema operacional) |
sankhyaimages/skdev-mssql:1.1.0 |
1433 | database jiva |
A escolha é feita por SANKHYA_DB_TYPE no .env — veja Configuração do banco.
Funcionalidades
| Tool | O que faz |
|---|---|
describe_table |
Colunas, tipos, nullable, descrição em português e todos os valores aceitos dos campos enumerados |
search_tables |
Busca tabelas por nome parcial (ex: TGF, TSIUSU), com a descrição de cada uma |
search_columns |
Descobre em quais tabelas existe determinado campo (ex: CODPARC), com a descrição por tabela |
search_entities |
Busca EntityNames (instâncias Sankhya) por nome ou descrição |
get_foreign_keys |
FKs do banco e as ligações lógicas do dicionário (as que o JAPE enxerga) |
get_indexes |
Mostra índices e suas colunas |
run_query |
Executa SELECT e retorna resultado formatado (somente leitura) |
validate_query |
Valida sintaxe SQL sem executar (EXPLAIN PLAN no Oracle, SHOWPLAN_ALL no SQL Server) |
table_sample |
Amostra de dados reais, com o rótulo ao lado do código (L (Liberada)) |
list_modules |
Visão geral dos módulos Sankhya por prefixo de tabela |
check_updates |
Diz se há versão mais nova publicada e o que mudou |
Por que describe_table traz os valores dos campos
O comentário de coluna do catálogo vem vazio na base Sankhya (0 de 69.782
colunas medidas). A semântica mora no dicionário da aplicação, e é de lá que a
tool tira a descrição (TDDCAM) e o domínio dos campos enumerados (TDDOPC):
| campo | tipo | nulo | descricao | opcoes |
| TIPMOV | VARCHAR2(1) | S | Tipo de Movimento | P=Pedido de venda; V=Venda; C=Compra; ... |
Sem isso, quem escreve a query precisa adivinhar o literal do WHERE. Em
TGFCAB.TIPMOV, V (Venda) e P (Pedido de venda) são ambos válidos —
trocar um pelo outro devolve o documento errado sem levantar nenhum erro de
SQL. E o mesmo nome de campo tem domínio diferente em tabelas diferentes:
TIPMOV existe em 17 tabelas, com de 2 a 24 opções cada.
설치
docker run -d --name skdev-oracle --network skdev --network-alias oracle --label com.docker.compose.project=skdev --restart unless-stopped --shm-size=1g -e ORACLE_PWD=troque_esta_senha -e TZ=America/Sao_Paulo -p 1521:1521 -v skdev-oracle-data:/u01/app/oracle/oradata frshaka/skdev-oracle:1.1.2