convez.ai
MCP ServerFinanceiroAvançado
Xaiver03

StartupOS AI Tools

Xaiver03/startupos-ai-tools

Toolkits de IA para gestão financeira e operacional de startups

Ver no GitHub
InicialPluginScore · de 0 a 100

Suite integrada de MCP servers, CLI e skills para gestão financeira de startups. Oferece automação de processos contábeis, recursos humanos, análise OCR e conformidade legal através de múltiplas camadas de integração com Claude e sistemas de IA.

Instalação

$npx convez-ai Xaiver03/startupos-ai-tools

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de processos contábeis e escrituração fiscal
  • Gestão integrada de folha de pagamento e RH
  • Análise de documentos financeiros com OCR inteligente
  • Integração com sistemas de IA para recomendações contábeis

Veredito

Projeto robusto voltado para ecossistema StartupOS, com arquitetura bem estruturada em MCP servers. Recomendado para equipes que precisam automação financeira e contábil integrada a Claude, mas exige configuração e familiaridade com Node.js/TypeScript.

README

A tradução para o português deste README ainda está na fila.

StartupOS AI Tools

AI Native 工具套件 - 为 StartupOS 财务管理系统提供 CLI、MCP 服务器和 AI 集成

npm version License


📦 项目结构

ai-tools/
├── cli/                    # CLI 命令行工具
│   ├── src/               # TypeScript 源码
│   ├── dist/              # 编译输出
│   ├── mcp-servers/       # 捆绑的 MCP 服务器(用于 NPM 发布)
│   └── package.json       # NPM 包配置
│
├── mcp-suite/             # MCP 服务器套件(源码)
│   └── packages/
│       ├── core/          # 核心服务(认证、CRUD、工作区)
│       ├── accounting/    # 会计服务(报表、凭证、账簿)
│       ├── hr/            # 人事服务(员工、薪资、合同)
│       ├── ai/            # AI 服务(智能记账、OCR)
│       ├── legal/         # 法务服务(合同审查、催款函)
│       └── shared/        # 共享库
│
├── chatbot/               # AI 聊天机器人(未实现)
├── web/                   # Web 界面(未实现)
└── mcp/                   # MCP 协议文档

🚀 快速开始

用户安装(NPM 包)

# 全局安装
npm install -g @xaiverdeng/ssos

# 一键安装所有工具
ssos setup

# 或使用 npx
npx @xaiverdeng/ssos setup

# 仅安装 MCP 服务器
ssos setup --mcp

# 仅安装 Claude Skills
ssos setup --skill

开发者设置(从源码)

前置要求:

步骤:

# 1. 安装依赖
cd ai-tools
npm install

# 2. 构建 MCP Suite
cd mcp-suite
npm install
npm run build  # 构建所有 5 个 MCP 服务器

# 3. 构建 CLI
cd ../cli
npm install
npm run build
npm link  # 全局链接,可直接使用 ssos 命令

# 4. 安装到 AI IDE
ssos setup --mcp

# 5. 验证安装
ssos doctor

🛠️ 开发工作流

修改 MCP 服务器

cd mcp-suite/packages/<module>
# 修改 src/ 中的代码
npm run build
# 或使用 watch 模式
npm run watch

修改 CLI 命令

cd cli
# 修改 src/commands/ 中的代码
npm run build
# 或使用 watch 模式
npm run watch

测试流程

# 1. 本地测试 CLI 命令
ssos --help
ssos doctor

# 2. 测试 MCP 服务器(需要重启 Claude Code)
# 修改代码 → npm run build → 重启 Claude Code

# 3. 运行单元测试(待实现)
npm test

📦 发布流程

发布 CLI 到 NPM

前置步骤: 确保 MCP Suite 已构建并复制到 cli/mcp-servers/

cd cli

# 1. 确保 mcp-servers/ 目录存在且包含所有 5 个包
ls -la mcp-servers/
# 应该看到: core, accounting, hr, ai, legal, shared, accounting-utils

# 2. 更新版本号
npm version patch  # 或 minor, major

# 3. 构建
npm run build

# 4. 测试打包内容
npm pack --dry-run
# 确认输出包含 128 个文件

# 5. 发布到 NPM
npm publish

# 6. 验证发布
npm view @xaiverdeng/ssos
npx @xaiverdeng/ssos@latest doctor

同步 MCP 服务器到 CLI

当 MCP Suite 有更新时,需要重新复制到 CLI:

# 从项目根目录运行
cd ai-tools

# 1. 构建 MCP Suite
cd mcp-suite && npm run build

# 2. 删除旧的捆绑文件
rm -rf ../cli/mcp-servers

# 3. 复制所有 dist 文件到 cli/mcp-servers/
mkdir -p ../cli/mcp-servers
for pkg in core accounting hr ai legal; do
  cp -r packages/$pkg/dist/* ../cli/mcp-servers/$pkg/
done

# 复制共享库
cp -r packages/shared/dist/* ../cli/mcp-servers/shared/

# 4. 发布新版本 CLI(见上面步骤)

🏗️ 架构设计

详见 ARCHITECTURE.md

📚 模块说明

CLI (cli/)

功能: 服务端命令行工具,51 个命令(v2.0 三层架构)

三层架构:

  • CRUD 层 (90%): 统一接口管理 127 种资源
  • 业务层 (8%): 会计报表、税务计算、发票操作
  • AI 层 (2%): 智能记账、OCR 识别、合规问答

主要模块:

  • crud - 通用 CRUD(7 actions × 127 资源)
  • accounting - 会计报表(7 个报表命令)
  • tax - 税务管理(6 个税务命令)
  • invoice - 发票操作(3 个转换命令)
  • ai-bookkeeping - AI 智能记账(5 个 AI 命令)
  • auth - 认证管理(3 种认证方式)
  • setup - 一键安装 MCP + Skills
  • doctor - 健康检查
  • users - 用户管理(密码重置)
  • workspace - 工作区统计

技术栈: TypeScript, Commander.js, PostgreSQL

MCP Suite (mcp-suite/)

功能: Model Context Protocol 服务器,为 AI IDE 提供工具和资源

5 个服务器:

服务器工具数主要功能
core13认证、工作区、通用 CRUD(127 资源)
accounting41报表、凭证、账簿、期末处理
hr10员工、薪资、合同管理
ai4智能记账、OCR 识别
legal13合同审查、风险评分、催款函

技术栈: TypeScript, @modelcontextprotocol/sdk

Skills (skills/)

功能: Claude Code 工作流技能

包含:

  • ssos-cli-v2.md - CLI v2.0 命令使用说明(三层架构)

🔧 故障排除

MCP 服务器未显示在 AI IDE

# 1. 检查配置文件
cat ~/.claude.json | grep startupos

# 2. 确认文件存在
ls -lh ~/.npm/_npx/*/node_modules/@xaiverdeng/ssos/mcp-servers/core/index.js

# 3. 重新安装
npx @xaiverdeng/ssos setup --mcp

# 4. 重启 AI IDE

CLI 命令找不到

# 如果使用 npm link
npm unlink @xaiverdeng/ssos
cd cli && npm link

# 如果使用 npx
npx clear-npx-cache
npx @xaiverdeng/ssos@latest --help

构建失败

# 清理并重新安装
rm -rf node_modules package-lock.json
npm install
npm run build

MCP 服务器路径错误

确保 cli/mcp-servers/ 包含所有文件:

cd cli
ls -la mcp-servers/
# 应该看到: core, accounting, hr, ai, legal, shared, accounting-utils

📖 相关文档

v2.0 文档

技术文档

🔗 外部链接


维护者: Finlaw Team
许可证: MIT

Ver o original no GitHub

Bom para

Relacionados