Skip to main content
Glama
kambleaa007

GrappleAI MCP Server

by kambleaa007

GrappleAI - 面向消费者的主动防御层

一个基于AI的纠纷解决平台,采用React前端和AWS CDK Lambda后端。GrappleAI通过自主代理和模型上下文协议(MCP)在购买后纠纷中为消费者维权。

🚀 快速启动

5分钟内即可运行:

# Frontend
cd app && npm install && npm run dev

# Backend (separate terminal)
cd backend && npm install && npm run cdk:deploy

详细说明请参见QUICKSTART.md

Related MCP server: korean-privacy-law-mcp

📚 文档

入门指南

方法论与愿景

组件文档

🏗️ 架构

React Frontend (Vite)
        ↓ HTTP/REST
API Gateway (AWS)
        ↓
Lambda Function (Node.js 20.x)
        ├─ MCP Server
        ├─ Request Handler
        └─ Business Logic
        ↓
    ┌───┴───┬────────┐
    ↓       ↓        ↓
DynamoDB  S3      DynamoDB
Disputes  Evidence Negotiations

✨ 功能

  • 纠纷管理 - 创建、追踪和管理纠纷

  • 证据验证 - 自动置信度评分与安全存储

  • 自主协商 - AI驱动的卖家协商

  • 消费者权益 - 2019年消费者保护法集成

  • 仪表板分析 - 实时纠纷统计

  • 多语言支持 - 本地语言界面支持

🛠️ 技术栈

前端

  • React 18 + TypeScript

  • Vite(构建工具)

  • Tailwind CSS(样式)

  • Zustand(状态管理)

  • React Router(导航)

后端

  • AWS CDK(基础设施即代码)

  • AWS Lambda(无服务器计算)

  • AWS API Gateway(REST API)

  • AWS DynamoDB(数据库)

  • AWS S3(存储)

  • Node.js 20.x

📁 项目结构

grappleai/
├── app/                    # React frontend
│   ├── src/
│   │   ├── components/    # React components
│   │   ├── pages/         # Page components
│   │   ├── services/      # API client
│   │   ├── store/         # State management
│   │   └── types/         # TypeScript types
│   └── package.json
│
├── backend/               # AWS CDK backend
│   ├── lib/
│   │   ├── cdk/          # CDK stack
│   │   ├── lambda/       # Lambda handler
│   │   ├── mcp/          # MCP server
│   │   └── types/        # TypeScript types
│   └── package.json
│
├── SDLC to AIDLC/        # Methodology docs
│   ├── AIDLC.md
│   └── SDLC.md
│
├── AI-DLC/               # AI-DLC documentation
│   └── AI-DLC.md
│
├── QUICKSTART.md         # 5-minute setup
├── SETUP.md              # Complete setup guide
├── PROJECT_OVERVIEW.md   # Architecture overview
└── README.md             # This file

🚀 开始使用

前提条件

  • Node.js 18+

  • AWS账户

  • 已配置AWS CLI

前端设置

cd app
npm install
npm run dev

访问:http://localhost:5173

后端设置

cd backend
npm install
npm run cdk:deploy

连接前后端

更新app/.env.local

VITE_API_URL=https://your-api-endpoint.com/api

📖 API端点

纠纷

  • POST /disputes - 创建纠纷

  • GET /disputes - 列出纠纷

  • GET /disputes/{id} - 获取纠纷详情

  • PUT /disputes/{id} - 更新纠纷

证据

  • POST /evidence/upload - 上传证据

  • GET /evidence/{id} - 获取证据

  • POST /evidence/{id}/verify - 验证证据

协商

  • POST /negotiation/initiate - 开始协商

  • GET /negotiation/{txId} - 获取状态

🔧 MCP服务器工具

后端实现以下MCP工具:

  1. secureEvidence - 通过置信度评分安全存储证据

  2. negotiateRefund - 发起自主协商

  3. generateDisputeNotice - 生成正式纠纷通知

  4. verifyConsumerRights - 验证消费者保护法权益

📊 仪表板功能

  • 统计信息 - 总纠纷数、已解决、处理中、成功率

  • 纠纷列表 - 查看所有纠纷及状态指示

  • 创建纠纷 - 上传证据提出新纠纷

  • 实时更新 - 追踪纠纷进展

🔐 安全

  • 支持JWT/OAuth2

  • 输入验证

  • IAM角色遵循最小权限原则

  • 静态与传输中数据加密

  • 启用CORS

  • 支持API速率限制

📈 性能

  • 前端:约50KB gzip压缩

  • Lambda:512MB内存,30秒超时

  • DynamoDB:按需计费

  • API:<100ms响应时间

💰 成本估算

月度(中小规模使用):

  • Lambda:每百万次请求$0.20

  • DynamoDB:每100个写入单元$1.25

  • S3:每GB $0.023

  • API Gateway:每百万次请求$3.50

  • 总计:约$50-200/月

🧪 开发

前端命令

npm run dev          # Start dev server
npm run build        # Build for production
npm run lint         # Run linter
npm run type-check   # Check types

后端命令

npm run build        # Compile TypeScript
npm run cdk:deploy   # Deploy to AWS
npm run cdk:destroy  # Destroy stack
npm run cdk:diff     # Preview changes

🚢 部署

前端

  • Vercel:vercel deploy

  • Netlify:netlify deploy --prod --dir=dist

  • AWS S3:aws s3 sync dist/ s3://bucket/

后端

cd backend
npm run cdk:deploy

📚 了解更多

🤝 贡献指南

  1. 创建功能分支

  2. 进行修改

  3. 运行代码检查和类型检查

  4. 提交拉取请求

📄 许可

MIT

🎯 愿景

GrappleAI正在为印度的数字经济构建信任层。通过结合AI、法律和技术,我们致力于为每位消费者创造主动的代言人——确保纠纷以公平、快速且消费者母语的方式得到解决。


准备开始构建?QUICKSTART.md开始!

GrappleAI - 面向消费者的主动防御层 一次解决一个纠纷,为印度数字经济建立信任。

A
license - permissive license
Not graded
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    C
    quality
    B
    maintenance
    Enables searching, comparing, and analyzing Korean laws and public institution regulations through natural language, integrating 110 MCP tools covering statutes, precedents, and internal rules.
    100
    12
    15
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables natural language interaction with the Korean Personal Information Protection Act (PIPA) through 37 MCP tools that search, compare, analyze, and verify legal texts, official guidelines, and consulting cases from authoritative sources.
    37
    11
    4
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides automated EU AI Act compliance tools, including risk classification, role determination, transparency disclosures, content watermarking, deepfake labeling, and security threat detection.
    16
    31
    Apache 2.0
  • A
    license
    B
    quality
    B
    maintenance
    Enables Korean legal document processing, case analysis, and consultation using MCP, with OCR parsing, fact extraction, claim identification, subsumption grid, legal API verification, and document drafting.
    24
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kambleaa007/GrappleAI'

If you have feedback or need assistance with the MCP directory API, please join our Discord server