Splynx插件MCP服务器
MCP（模型上下文协议）服务器，为开发Splynx插件提供全面的工具、文档和指导工作流程。当连接到Claude Code（或任何MCP客户端）时，它能够在充分了解平台架构、API和约定的情况下，实现AI辅助的Splynx插件开发。
特性
资源（19个文档主题）
完整的Splynx插件开发参考直接嵌入服务器：
- 插件架构 -目录结构、关键概念、生命周期
- InstallController -API权限、入口点、挂钩、附加字段
- 配置文件 -具有块、项目、字段类型的设置UI定义
- 入口点 -菜单链接、代码注入、操作链接、选项卡
- 钩子 -拥有800多个可用活动的活动系统
- 数据库 -MySQL和SQLite配置
- 模型 -BaseCustomer、BaseActiveApi、ActiveRecord模式
- 控制器 -访问控制、错误处理、多身份验证
- 视图 -Twig模板、布局、Bootstrap UI
- Web 配置 -Yii2应用程序配置
- 付款插件 -支付网关集成指南
- 数据集 -自定义实体/模块创建
- 浏览器通信 -通知、WebSocket、Redis
- 用户授权 -管理员、客户和多身份验证
- 史普林克斯API -REST API v2.0参考（身份验证、端点、过滤）
- 喉部平台 -完整的平台概述（所有模块）
- 会计插件 -OAuth2同步引擎、实体配对、速率限制、PID锁定（QuickBooks/Xero模式）
- 电子发票插件 -政府税务机关提交、跟踪器模式、XML生成、哈希链、二维码（AADE/Verifactu模式）
- 高级模式 -仅控制台插件、ActionInterface、双数据库、存储库缓存、银行导入、费用注册表、cron管道、佣金引擎
工具（9个代码生成器）
- 脚手架_巴顿 -生成包含所有文件的完整插件骨架
- generate_install_controller -生成InstallController.php
- generate_config_json -生成config.json设置定义
- 发电机控制器 -生成具有访问控制的Yii2控制器
- 发电机模型 -生成模型（API、ActiveRecord、SQLite、数据集）
- generate_view -生成Twig视图（表格、表单、仪表板）
- generate_hok_controller -生成HookController用于事件处理
- generate_web_config -生成config/web.php
- 发电机迁移 -生成数据库迁移
提示（9个指导工作流程）
- create_addon -从头开始创建完整的插件（通用、支付、监控、集成、会计、电子发票、报告、通知）
- 创建_计数_插件 -引导式会计/ERP集成（OAuth2、同步引擎、实体配对）
- create_invoicing_addon -引导式电子发票插件（政府API、XML、证书）
- add_hook_handler -向现有插件添加事件处理
- add_payment_gateway -集成支付网关
- add_custom_dataset -创建新实体类型
- add_entry_point -添加UI集成点
- explain_splinx-api -深入了解API端点
- 调试插件 -诊断常见插件问题
安装
# Clone and build
git clone
cd splynx-addons-mcp-server
npm install
npm run build用法
选项1：本地（stdio模式）
添加到您的Claude Code MCP设置中(~/.claude/claude_desktop_config.json 或项目 .mcp.json):
{
"mcpServers": {
"splynx-addons": {
"command": "node",
"args": ["/path/to/splynx-addons-mcp-server/dist/index.js"]
}
}
}选项2：远程HTTP服务器
以HTTP模式运行服务器，以便客户端可以通过URL连接：
node dist/index.js --http --port=3000 --host=0.0.0.0客户端使用其MCP配置中的远程URL进行连接：
{
"mcpServers": {
"splynx-addons": {
"type": "url",
"url": "https://mcp-addons.splynx.com/mcp"
}
}
}选项3：Docker部署
# Build
docker build -t splynx-addons-mcp .
# Run
docker run -d --name splynx-mcp --restart always -p 3000:3000 splynx-addons-mcp部署到mcp-addons.splynx.com
Nginx反向代理配置：
server {
listen 443 ssl;
server_name mcp-addons.splynx.com;
ssl_certificate /etc/letsencrypt/live/mcp-addons.splynx.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/mcp-addons.splynx.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 86400s;
}
}健康检查
curl https://mcp-addons.splynx.com/health
# {"status":"ok","server":"splynx-addons-mcp","version":"1.0.0"}______________________________________________________________________
然后，在Claude Code中，您可以：
- 要求创建一个新的Splynx插件，AI将使用脚手架工具
- 询问任何Splynx主题，AI都会参考嵌入的文档
- 使用“create_addon”等提示进行指导性工作流
快速入门示例
> Create a Splynx addon called "SMS Notifications" that sends SMS when
> customers are created or invoices are generated克劳德将自动：
- 阅读插件架构文档
- 生成一个启用挂钩的完整插件脚手架
- 使用正确的API权限和挂钩事件配置InstallController
- 创建HookController以处理客户/创建和发票/创建事件
- 设置短信网关凭据的config.json
- 将所有文件写入项目
Splynx文档参考
- Addon Howto -官方发展指南
- Addon骨架 -初学者模板
- Splynx API 2.0版 -REST API文档
- Splynx维基 -平台文档