🏥 Ninsaúde MCP服务器
完整的 MCP 服务器与 API 集成 宁萨德诊所 通过人工智能智能管理医疗诊所。
🎉 74 可用工具 ✅
📊 Módulo简历
模块
工具
操作
👥 病人
4
列出,搜索,创建,更新
📅 代理
3
列出,创建,重新安排,取消
📋 搜索表格
5
CRUD完成
💰 收入/收据 2、创建,创建
💸 费用/付款 2、创建,创建
📄 模型文件
1
列表
📊 基本财务报告
3
现金流,类别
👨⚕️ 医疗保健专业人员
3
列表,搜索,议程
🏥 协议/计划
2
列出,搜索
🔬 医疗服务
2
列出,搜索
🏦 银行账户
2
列表, 余额
📦 供应商 2、创建,创建
🏷️ 金融类别 2、收入/支出列表
📈 高级报告
4
付款方式,违约,专业,协议
📝 医疗记录
4
列出,搜索,创建,更新
📦 产品/库存
2
产品列表,库存水平
🔄 传输标题
3
列出,搜索,添加批次
💊 药物
2
Listar、公共汽车(基地中心)
💊 档案规定
4
CRUD完成
🧪 处方药
3
列出,添加,删除
📓 记录笔记
4
CRUD完成
🤧 阿勒吉斯
4
CRUD完成
🗂️ 记录文件
2
列出,搜索
🔀 路由器 3、搜索、创建
🚪 诊所房间
2
列出,搜索
💳 付款方式
2
列出,搜索
🩺 医疗专业
1
列表
🏷️ CID-10
2
按代码/描述搜索
🗺️ 城市 / CEP
2
查找CEP,列出城市
💱 资金转移 3、创建、搜索
🏗️ 剑库
2
列出,搜索
📦 库存转移 2、创建,创建
📊 服务报告
8
超载,季节性,性别,峰值,服务,协议,数量,总
🧾 税务说明(NFS-e)
4
列出,取消,发送电子邮件,统计
💰 Ninsalud Pay 收费
3
列表,搜索,付款链接
总计
74
🚀 快速入门
先决条件
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
进入Ninsaúde Clinic面板
进去 设置 → 集成 → API
Gere嗯 刷新令牌 用于您的应用
粘贴值到 .env 怎么 NINSAUDE_REFRESH_TOKEN
或者使用已经包含的辅助脚本:
构建
执行
配置程序无克劳德桌面/光标
添加到 claude_desktop_config.json:
复制 {
"mcpServers": {
"ninsaude": {
"command": "node",
"args": ["/caminho/para/ninsaude-mcp-server/dist/index.js"]
}
}
}
📚 可用工具
1. 👥 病人(4个工具)
工具
描述
list_patients 用过滤器列出患者
get_patient
按ID搜索患者
create_patient 创造新病人
update_patient 更新患者数据。
复制 // 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 个工具)
工具
描述
list_appointments
列出日程安排
create_agendamento 创建新日程安排
update_agendamento
重组咨询
cancel_agendamento 取消预约
复制 // 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个工具)
工具
描述
list_receitas
列出日期过滤器
create_receita 注册收据。
复制 // Receitas de hoje
{
dataPagamentoInicial: "2026-02-23",
dataPagamentoFinal: "2026-02-23"
}
5. 💸 支出/付款(2个工具)
list_despesas — 列出费用
create_despesa — 记录费用
6. 📊 财务报告(7个工具)
工具
描述
get_fluxo_caixa_report 按期的现金流量。
get_categoria_receita_report 按类别的收入
get_categoria_despesa_report 按类别开支。
get_tipo_pagamento_report
按付款方式(PIX,卡,现金…)
get_inadimplencia_report 迟到的付款。
get_profissional_report 医生收费。
get_convenio_report 按协议计费。
复制 // 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个工具)
工具
描述
list_prontuario_prescricoes 列出处方。
get_prontuario_prescricao
按ID搜索
create_prontuario_prescricao 创建处方。
update_prontuario_prescricao 更新处方。
复制 // 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个工具)
工具
描述
get_atendimento_sobrecarga_report 按专业人士的工作量。
get_atendimento_sazonalidade 月度/周度趋势
get_atendimento_sexo_pacientes 性别分布
get_atendimento_horarios_pico 需求较高的时间。
get_atendimento_servicos_mais_vendidos 最完成的服务。
get_atendimento_convenios_mais_vendidos 最常用的协议。
get_atendimento_quantidades 服务,缺席,取消。
get_total_pacientes 一般患者。
复制 // 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.
变量
强制性
描述
NINSAUDE_API_URL
✅
API的URL基础(padrão: https://api.ninsaude.com/v1)
NINSAUDE_REFRESH_TOKEN
✅
在 Ninhealth 面板中生成的 OAuth2 刷新令牌
国际功能:
在第一个请求中,服务器交换 refresh_token 由一个 access_token
哦 access_token 每次自动更新 14分钟 (到期15分钟前)
所有 API 调用均可透明认证 — 无需人工干预
📈 Ninsaúde API 覆盖范围
度量
价值
实施的工具。 74
模块覆盖。 35
使用的端点
~90
已开发的 API 资源
集合中有 292 个可用
📞 附加文档
档案
内容
FUNCIONALIDADES.md
搜索表格的详细信息
FINANCEIRO.md
金融模块指南
MODELOS_E_RELATORIOS.md 文件和报告模板
MEDICAMENTOS.md 基于药物的整合。
MODO_PRESCRICAO_BRITENS.md Britens处方模型
RESUMO_COMPLETO.md 执行摘要
🏆 版本历史
版本
工具
新闻
v1.0
16
病人, 日程安排, 基本财务
v1.5
23
库存, 库存, 基本报告
v2.0
39
专业人员, 会议, 供应商, 高级报告
v2.5
43
药物, 转让证书
v3.0
74
处方, 过敏, NFS-E, 支付, 护理分析, CID, CEP
版本 : 3.0.0
已更新 2026年2月
状态 : ✅ 生产 — 74 活跃工具