Ninsaude MCP Server

🏥 Ninsaúde MCP服务器

完整的 MCP 服务器与 API 集成 宁萨德诊所 通过人工智能智能管理医疗诊所。

](https://github.com/Sudo-psc/ninsaude-mcp-server)

______________________________________________________________________

🎉 74 可用工具 ✅

📊 Módulo简历

______________________________________________________________________

🚀 快速入门

先决条件

• Node.js 18+
• Ninsaúde Clinic的活跃账户，可访问API

安装

git clone https://github.com/Sudo-psc/ninsaude-mcp-server.git
cd ninsaude-mcp-server
npm install

配置

创建文件 .env （使用o .env.example 作为基础）：

NINSAUDE_API_URL=https://api.ninsaude.com/v1
NINSAUDE_REFRESH_TOKEN=seu_refresh_token_aqui

⚠️ 只有 REFRESH_TOKEN 这是必要的。 服务器仅使用此令牌通过 OAuth2 自动验证 - 无需 CLIENT_ID 没有 CLIENT_SECRET.

🔑 如何获取REFRESH_TOKEN

1. 进入Ninsaúde Clinic面板
2. 进去 设置 → 集成 → API
3. Gere嗯 刷新令牌 用于您的应用
4. 粘贴值到 .env 怎么 NINSAUDE_REFRESH_TOKEN

或者使用已经包含的辅助脚本：

node capture-token.js

构建

npm run build

执行

node dist/index.js

配置程序无克劳德桌面/光标

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "ninsaude": {
      "command": "node",
      "args": ["/caminho/para/ninsaude-mcp-server/dist/index.js"]
    }
  }
}

______________________________________________________________________

📚 可用工具

1. 👥 病人（4个工具）

// Exemplo: listar pacientes
{ limit: 10, nomeExato: "Maria Silva", cpf: "12345678900" }

// Exemplo: criar paciente
{
  nome: "João da Silva",
  cpf: "12345678900",
  dataNascimento: "1990-01-15",
  sexo: "M",
  email: "joao@email.com",
  foneCelular: "(31) 99999-1234"
}

______________________________________________________________________

2. 📅 日程安排 （3 个工具）

// Listar agendamentos do dia
{
  dataInicial: "2026-02-23",
  dataFinal: "2026-02-23",
  status: 4 // 0=Agendado,1=Espera,2=Conf,3=Atend,4=Atendido,5=Cancel
}

______________________________________________________________________

3. 📋 搜索表格（5个工具）

• list_surveys — 列出表单
• get_survey -按ID搜索
• create_survey — 创建表单
• update_survey — 更新表格
• delete_survey — 删除表单

______________________________________________________________________

4. 💰 收据/收据（2个工具）

// Receitas de hoje
{
  dataPagamentoInicial: "2026-02-23",
  dataPagamentoFinal: "2026-02-23"
}

______________________________________________________________________

5. 💸 支出/付款（2个工具）

• list_despesas — 列出费用
• create_despesa — 记录费用

______________________________________________________________________

6. 📊 财务报告（7个工具）

// Todos usam:
{ dataInicial: "2026-02-01", dataFinal: "2026-02-28", accountUnidade: 1 }

______________________________________________________________________

7. 👨‍⚕️ 医疗保健专业人员 （3 工具）

• list_profissionais — 列出过滤器
• get_profissional -按ID搜索
• list_profissional_agenda — 时间网格

______________________________________________________________________

8. 🏥 会议/健康计划（2个工具）

• list_convenios — 列出协议
• get_convenio -按ID搜索

______________________________________________________________________

9. 🔬 医疗服务（2个工具）

• list_servicos 列出服务/程序
• get_servico -按ID搜索

______________________________________________________________________

10. 🏦 银行账户（2个工具）

• list_contas — 列出已注册帐户
• get_conta_saldo 所有账户的当前余额

______________________________________________________________________

11. 📦 供应商 （2 工具）

• list_fornecedores — 供应商列表
• create_fornecedor — 注册供应商

______________________________________________________________________

12. 🏷️ 金融类别 （2 工具）

• list_categorias_receita — 收入类别
• list_categorias_despesa — 费用类别

______________________________________________________________________

13. 📝 医疗手册 （4 工具）

• list_prontuarios — 记录清单
• get_prontuario -按ID搜索
• create_prontuario — 创建投诉记录， 诊断， 行为
• update_prontuario 更新记录

______________________________________________________________________

14. 💊 手册规定（4个工具）

// Criar prescrição vinculada ao prontuário
{
  prontuario: 456,
  descricao: "Receituário do dia",
  tipo: 0 // 0=Simples, 1=Controle especial
}

______________________________________________________________________

15. 🧪 处方药（3个工具）

• list_prescricao_medicamentos — 列出项目
• create_prescricao_medicamento 添加药物
• delete_prescricao_medicamento 删除药物

// Adicionar medicamento à prescrição
{
  prescricao: 789,
  medicamento: 1234, // ID da base central
  posologia: "1 gota 3x ao dia",
  quantidade: 1,
  unidade: "frasco"
}

______________________________________________________________________

16. 📓 记录笔记 （4 个工具）

• list_prontuario_notas -列出临床笔记
• create_prontuario_nota — 创建笔记
• update_prontuario_nota -编辑注释
• delete_prontuario_nota — 删除备注

______________________________________________________________________

17. 🤧 患者过敏（4种工具）

• list_alergias --警报列表
• create_alergia — 过敏记录
• update_alergia 过敏更新
• delete_alergia --去除脱发

{
  paciente: 123,
  descricao: "Dipirona",
  tipo: 0,     // 0=Medicamento,1=Alimento,2=Ambiente,3=Outro
  gravidade: 2 // 0=Leve,1=Moderada,2=Grave
}

______________________________________________________________________

18. 🗂️ 记录文件 （2 个工具）

• list_prontuario_documentos — 列出文件（考试，证书）
• get_prontuario_documento -按ID搜索

______________________________________________________________________

19. 🔀 路由器 （3 个工具）

• list_encaminhadores — 转诊医生列表
• get_encaminhador -按ID搜索
• create_encaminhador — 注册路由器

______________________________________________________________________

20. 🚪 诊所房间（2个工具）

• list_salas — 服务室列表
• get_sala -按ID搜索房间

______________________________________________________________________

21. 💳 付款方式 （2 工具）

• list_tipos_pagamento — PIX，卡，现金，支票等。
• get_tipo_pagamento -按ID搜索

______________________________________________________________________

22. 🩺 医疗专业 （1 工具）

• list_especialidades — 列出专业 （眼科， 心脏病学， 等等）

______________________________________________________________________

23. 🏷️ CID-10（2个工具）

• list_cid 按代码或描述搜索疾病
• get_cid 特定CID的详细信息

// Buscar diagnósticos
{ descricao: "diabetes" }    // por nome
{ codigo: "E11" }            // por código CID

______________________________________________________________________

24. 🗺️ 城市 / CEP （2 工具）

• buscar_endereco_por_cep — 通过CEP返回logradouro，社区，城市
• list_cidades 按州/国家列出城市

{ cep: "01310100" } // Sem traços

______________________________________________________________________

25. 💱 资金转移（3个工具）

• list_transferencias — 列出账户之间的转账
• create_transferencia — 进行转移
• get_transferencia -按ID搜索

{
  contaOrigem: 1,
  contaDestino: 3,
  valor: 500.00,
  data: "2026-02-23",
  observacao: "Sangria do caixa"
}

______________________________________________________________________

26. 🏗️ 库存存款 （2 工具）

• list_depositos -列出阿尔莫萨里费/矿床
• get_deposito -按ID搜索

______________________________________________________________________

27. 📦 库存移动（2个工具）

• list_movimentacoes_estoque — 列出输入/输出/转移
• create_movimentacao_estoque — 记录动作

{
  produto: 10,
  quantidade: 5,
  tipo: 0,          // 0=Entrada, 1=Saída, 2=Transferência
  data: "2026-02-23",
  depositoDestino: 1
}

______________________________________________________________________

28. 📊 服务报告（8个工具）

// Todos usam (exceto get_total_pacientes):
{ dataInicial: "2026-02-01", dataFinal: "2026-02-28", profissional: 1 }

______________________________________________________________________

29. 🧾 NFS-e 税务说明 （4 个工具）

• list_notas_fiscais — 列出 NFS-e （按日期或状态）
• get_nota_fiscal_estatisticas 发行总额和价值
• cancelar_nota_fiscal — 按 ID 取消 NFS
• enviar_nota_fiscal_email 通过电子邮件发送 NFS

______________________________________________________________________

30. 💰 收费Ninsaúde Pay （3 工具）

• list_cobrancas — 列出收费/门票
• get_cobranca — 按 ID 查找收费
• get_link_cobranca — 获取付款链接以共享

______________________________________________________________________

31. 💊 中央基础药物（2个工具）

• list_medicamentos - 在药物数据库中搜索（只读）
• get_medicamento 一种药物的细节

______________________________________________________________________

32. 🔄 传输标题 （3 个工具）

• list_titulos_transferencias — 列出调解标题
• get_titulo_transferencia -按ID搜索
• add_titulos_lote — 批量添加标题

______________________________________________________________________

💡 使用范例

🩺 完整的临床流程

// 1. Buscar paciente
const paciente = await list_patients({ nomeExato: "Maria Silva" });

// 2. Verificar alergias
const alergias = await list_alergias({ paciente: paciente.result[0].id });

// 3. Criar prontuário
const prontuario = await create_prontuario({
  paciente: paciente.result[0].id,
  profissional: 1,
  data: "2026-02-23",
  hora: "14:30:00",
  queixaPrincipal: "Olho seco e ardência",
  diagnostico: "Ceratoconjuntivite seca",
  conduta: "Lubrificante ocular 4x/dia"
});

// 4. Criar prescrição
const prescricao = await create_prontuario_prescricao({
  prontuario: prontuario.result.id,
  descricao: "Receituário Simples"
});

// 5. Adicionar medicamento
await create_prescricao_medicamento({
  prescricao: prescricao.result.id,
  descricao: "Colírio Lacrifilm",
  posologia: "1 gota em cada olho, 4x ao dia",
  quantidade: 1,
  unidade: "frasco"
});

📊 当天的财务仪表板

const hoje = "2026-02-23";

const dashboard = {
  receitas: await list_receitas({
    dataPagamentoInicial: hoje,
    dataPagamentoFinal: hoje
  }),
  despesas: await list_despesas({
    dataPagamentoInicial: hoje,
    dataPagamentoFinal: hoje
  }),
  fluxo: await get_fluxo_caixa_report({
    dataInicial: hoje,
    dataFinal: hoje
  }),
  tipoPagamento: await get_tipo_pagamento_report({
    dataInicial: hoje,
    dataFinal: hoje
  }),
  saldos: await get_conta_saldo({})
};

📅 代理系统

// Verificar agenda do dia e horários de pico
const agendamentos = await list_appointments({
  dataInicial: "2026-02-23",
  dataFinal: "2026-02-23"
});

const pico = await get_atendimento_horarios_pico({
  dataInicial: "2026-01-01",
  dataFinal: "2026-02-23"
});

______________________________________________________________________

🧪 测试

# Teste completo das ferramentas
node test-39-tools.js

# Módulo financeiro
node test-financial.js

# Criar receita/despesa de teste
node test-create-financial.js

# Formulários de pesquisa
node test-surveys.js
node test-crud-surveys.js

______________________________________________________________________

📁 项目结构

ninsaude-mcp-server/
├── src/
│   ├── index.ts          # Servidor MCP (74 ferramentas)
│   └── api.ts            # Cliente da API Ninsaúde
├── lib/
│   └── auth.js           # Módulo de autenticação
├── dist/                 # Build TypeScript compilado
├── .env                  # Credenciais (não versionado)
├── .env.example          # Template de credenciais
├── generate-billing-report.js  # Script de relatório de faturamento
├── capture-token.js      # Capturar token OAuth2
└── README.md

______________________________________________________________________

🔐 认证

服务器管理 自动 全部 OAuth2 身份验证。你只需要提供 REFRESH_TOKEN 不 .env.

国际功能：

1. 在第一个请求中，服务器交换 refresh_token 由一个 access_token
2. 哦 access_token 每次自动更新 14分钟 （到期15分钟前）
3. 所有 API 调用均可透明认证 — 无需人工干预

______________________________________________________________________

📈 Ninsaúde API 覆盖范围

______________________________________________________________________

📞 附加文档

______________________________________________________________________

🏆 版本历史

______________________________________________________________________

版本: 3.0.0\ 已更新2026年2月\ 状态: ✅ 生产 — 74 活跃工具