Neonpanel MCP Server

MCP服务器集合

用于NeonPanel和Keepa API的生产就绪模型上下文协议（MCP）服务器。

🚀 项目

NeonPanel MCP服务器

通过提供程序OAuth承载验证、JSON-RPC工具和SSE传输，在NeonPanel REST API上进行精简MCP桥接。

关键能力

• neonpanel.listCompanies
• neonpanel.listReports
• neonpanel.listInventoryItems
• neonpanel.listWarehouses
• neonpanel.getWarehouseBalances
• neonpanel.getInventoryDetails
• neonpanel.getInventoryLandedCost
• neonpanel.getInventoryCogs
• neonpanel.getRevenueAndCogs
• neonpanel.getImportInstructions
• neonpanel.createDocuments
• neonpanel.createDocumentsByPdf
• neonpanel.checkImportStatus

操作端点

• GET /healthz –准备/诊断(?deep=1 执行JWKS+模式可达性检查）
• POST /mcp –可流式传输的HTTP JSON-RPC（公共发现；OAuth用于 tools/call)
• GET /sse –事件流（连接时不需要身份验证）
• POST /messages –JSON-RPC接收器（与SSE会话一起使用）

端点

主控程序

• POST /mcp （流式HTTP/JSON-RPC）

- 公开（无OAuth）： initialize, initialized, tools/list - 需要OAuth： tools/call - 如果承载令牌丢失/无效，服务器将返回 HTTP 401 并且包括以下两者： - WWW-Authenticate: Bearer ... resource_metadata="https://mcp.neonpanel.com/.well-known/oauth-protected-resource" - JSON-RPC错误，其 error.data._meta['mcp/www_authenticate'] 包含相同的挑战

• GET /sse （可选SSE传输）

- 是否 不 需要auth才能打开流。 - 服务器发出 endpoint SSE事件指向 POST /messages?sessionId=....

OAuth元数据

• GET /.well-known/oauth-protected-resource
• GET /.well-known/oauth-authorization-server

开发人员工作流程

• npm run dev –在监视模式下启动服务器
• npm run test –执行单元测试（节点测试运行器通过 tsx)
• npm run openapi:refresh –强制刷新NeonPanel OpenAPI文档并将其保存在本地
• scripts/mcp_check.sh –快速烟雾击中 /healthz, initialize，以及 tools/list （要求 ACCESS_TOKEN)

生产： https://mcp.neonpanel.com

📊 雅典娜（FBA策划）

工具 amazon_supply_chain.fba_list_replenish_asap 对Glue数据目录运行Athena查询。

配置（环境变量）

• ATHENA_CATALOG （默认值 awsdatacatalog)
• ATHENA_DATABASE （默认值 inventory_planning)
• ATHENA_TABLE_INVENTORY_PLANNING_SNAPSHOT （默认值 inventory_planning_snapshot)
• ATHENA_WORKGROUP （默认值 primary)
• ATHENA_OUTPUT_LOCATION （可选；如果您的工作组没有结果位置，则为必填项）
• ATHENA_ASSUME_ROLE_ARN （可选；如果设置，服务器将 sts:AssumeRole 查询前）
• AWS_REGION （AWS SDK需要）

根据产品数据进行本地开发（使用您的AWS配置文件）

aws sso login --profile aap-prod-administrator

AWS_PROFILE=aap-prod-administrator \
AWS_REGION=us-east-1 \
npm run dev

在生产环境（ECS/Fargate）中，默认情况下凭据来自任务角色。如果数据集位于其他AWS帐户中，请设置 ATHENA_ASSUME_ROLE_ARN 该帐户中信任任务角色的角色。

维护MCP服务器

通过Keepa API进行亚马逊产品跟踪和价格分析。

工具： getProduct, searchProducts, getBestSellers

📦 快速开始

# Clone
git clone https://github.com/5starsunited/neonpanel-mcp-server.git
cd neonpanel-mcp-server

# Install & Build
npm install
npm run build

# Run
npm run dev

🔧 发展

NeonPanel MCP

npm run dev  # Starts on port 3030

# Testing
./test-oauth-compliance.sh
./test-bearer-auth.sh
./test-mcp-server-complete.sh

# DCR Broker CLI
npm run dcr:broker -- register chatgpt --iat=TOKEN --out .dcr/chatgpt.json

保留MCP

cd keepa-mcp
npm install
cp .env.example .env  # Add KEEPA_API_KEY
npm start

🚀 部署

AWS Fargate（NeonPanel）

aws sso login --profile app-dev-administrator

# Option A: use the repo deploy script (recommended)
./DEPLOY.sh

# Override profile explicitly (script does not honor AWS_PROFILE)
DEPLOY_AWS_PROFILE=app-dev-administrator ./DEPLOY.sh

# Option B: deploy CDK directly
cd infrastructure
npm install
cdk deploy --profile app-dev-administrator

🔐 认证

NeonPanel OAuth流程：

1. 国际航空运输协会 (3h) → 注册客户
2. 远程访问木马 （30天）→ 管理客户
3. 访问令牌 → 用户会话

发现：

• /.well-known/oauth-authorization-server
• /.well-known/ai-plugin.json
• /openapi.json

📖 文档

• ChatGPT集成
• OAuth架构
• 部署指导
• 保留API文档

🏗️ 建筑

ChatGPT → ALB (HTTPS) → Fargate → MCP Server → NeonPanel API

堆栈：

• Express+MCP SDK
• JWT验证（JWKS）
• AWS ECS/Fargate
• CDK基础设施

🧪 测试

# NeonPanel
./test-oauth-compliance.sh
./test-dcr-complete.sh
./test-bearer-auth.sh

# Keepa
cd keepa-mcp && npm test

🤝 贡献

1. Fork存储库
2. 创建特征分支
3. 提交更改
4. 推送并打开PR

📄 许可证

有关许可证信息，请参阅项目子目录。

🔗 链接

• NeonPanel
• MCP协议
• 保持API

存储库： https://github.com/5starsunited/neonpanel-mcp-server 最后更新时间： 2025年10月16日