AI导哈

ERP插件

AureusERP MCP插件为AI客户端提供安全的ERP工具访问，包含开发代理服务器和ERP代理服务器，支持文档搜索、业务洞察等功能。

  • by aureuserp
  • PHP
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 aureuserp/mcp

使用说明

Aureuserp MCP插件

此插件将MCP服务器添加到AureusERP中，以便AI客户端（MCP检查器、编码代理、ERP助理）可以安全地使用ERP工具。

这个插件提供了什么

暴露了两个MCP服务器：

开发代理服务器

传输 端点/命令 身份验证
标准 （工匠） php artisan mcp:dev 无--本地进程
超文本传输协议 POST /mcp/dev OAuth承载令牌

通过以下方式将stdio传输用于本地AI编码代理（Cursor、Claude Code、GitHub Copilot等） .mcp.json。对远程或OAuth身份验证的客户端使用HTTP传输。

工具：文档搜索、插件内省、路径发现、模型检查、Filament资源列表、API资源发现。

ERP代理服务器

传输 端点 身份验证
超文本传输协议 POST /mcp/erp OAuth承载令牌

只读业务洞察（销售、采购、发票、会计、库存、项目等34个工具）。没有stdio传输--此服务器需要身份验证。

OAuth发现+注册端点也公开了（通过 Mcp::oauthRoutes()):

  • GET /.well-known/oauth-protected-resource/{path?}
  • GET /.well-known/oauth-authorization-server/{path?}
  • POST /oauth/register

需求

  • PHP ^8.2
  • 拉瑞维尔 ^11
  • 灯丝 ^4
  • laravel/mcp ^0.5
  • laravel/passport ^13
  • AureusERP插件管理器

安装

首先，通过Composer需要该包：

composer require aureuserp/mcp

然后，您可以通过两种方式完成安装：

选项1：通过命令行

运行：

php artisan mcp:install

此命令自动执行设置：

  • 发布CORS配置(config/cors.php)如果尚未发布
  • 发布MCP OAuth授权视图(mcp-views)
  • 运行Passport API安装脚手架(install:api --passport)
  • 确保 config/auth.php 有MCP API保护/提供商
  • 从MCP插件服务提供商配置Passport授权视图
  • 清除缓存

选项2：通过Web插件管理器

导航到AureusERP管理面板中的插件管理器，并从那里安装MCP插件。

插件安装挂钩

如果您通过插件管理器或编辑器进行安装，安装程序将从插件安装命令自动触发。

运输： streamable-http （HTTP）/ stdio （工匠）

刀具目录

开发代理服务器

可通过 标准 (php artisan mcp:dev)以及 超文本传输协议 (POST /mcp/dev).

适用于开发人员和编码代理。总是打电话 search_docs 在编写任何插件或功能代码之前。

工具（7）

  • search_docs --在devdocs.AureusERP.com上搜索AureusERP开发人员的官方文档
  • list_plugins --列出所有已安装的插件及其激活状态
  • plugin_summary --获取插件详细信息、依赖关系图和安装状态
  • route_list --列出按插件、HTTP方法或URI前缀筛选的已注册路由
  • filament_resource_list --列出每个面板的Filament资源、页面和小部件
  • plugin_model_list --检查Eloquent模型：表、可填充、类型转换、关系、软删除
  • api_resource_list -发现每个插件和版本的JSON API资源类（V1、V2…）

资源（1）

  • DevGuideResource (erp://mcp/dev-guide)--构建AureusERP插件的开发人员指南和快速命令

提示（1）

  • DevCodingPrompt --为针对特定插件的编码任务构建面向开发人员的提示有效负载

ERP代理服务器

可通过 仅限HTTP (POST /mcp/erp，需要OAuth）。适用于查询ERP数据的业务用户和AI助手。所有工具都是 只读.

销售（5工具）

  • sales_order_insights --最近的订单、收入、按时期统计的数量、表现最佳的公司
  • sales_order_fulfillment_status --交付状态和逾期承诺
  • sales_pipeline_summary --潜在客户和机会
  • sales_team_performance --团队指标
  • sales_quotation_conversion --按订单报价费率

采购（4个工具）

  • purchase_orders_pending --待定订单
  • purchase_spend_summary --支出分析
  • purchase_requisition_queue --待处理的请购单
  • purchase_supplier_delivery_risk --交付风险

发票（6个工具）

  • invoice_list --所有发票
  • invoice_overdue_summary --逾期金额
  • invoice_aging_buckets --0-7、8-30、31+天
  • invoice_payment_followups --跟进候选人
  • invoice_status_breakdown --状态和付款状态
  • credit_notes_overview --客户信用票据和供应商退款（计数、金额、顶级合作伙伴）

会计（9种工具）

  • account_receivable_summary --应收账款金额
  • account_payable_summary --AP金额
  • account_move_state_breakdown --期刊声明
  • account_payment_state_breakdown --付款状态
  • accounting_cashflow_snapshot --现金流量
  • accounting_tax_liability_snapshot --纳税义务
  • accounting_journal_entry_health --入境问题
  • accounting_unposted_entries --未张贴的条目
  • bank_statement_queue --待和解

库存（6个工具）

  • inventory_low_stock_alerts --库存低
  • inventory_out_of_stock_items --缺货
  • inventory_replenishment_queue --重新订购商品
  • inventory_location_balance --按地点分类的库存
  • inventory_operation_backlog --待定操作
  • inventory_warehouse_kpis --仓库指标

项目（4个工具）

  • project_status_overview --活跃项目
  • project_task_backlog --按状态列出的任务
  • project_deadline_risk --逾期任务
  • project_timesheet_summary --记录时间

提示（5）

  • SalesSummaryPrompt --销售查询指南
  • PurchaseSummaryPrompt --购买查询指南
  • InvoiceSummaryPrompt --发票查询指南
  • InventorySummaryPrompt --库存查询指南
  • ProjectSummaryPrompt --项目查询指南

安全

所有ERP代理服务器工具 只读。它们只检索数据，不进行创建、更新或删除操作。这确保了AI助手可以安全地查询业务数据，而无需对系统进行更改。

示例用法

通过MCP客户端连接

这两台服务器都可以在任何支持MCP兼容的编辑器或AI代理中注册 mcp.json / .mcp.json 配置（VS代码、游标、克劳德代码、风帆等）。

{
    "servers": {
        "aureus-dev-mcp-server": {
            "command": "php",
            "args": [
                "artisan",
                "mcp:dev"
            ]
        },
        "aureus-erp-mcp-server": {
            "url": "http://127.0.0.1:8000/mcp/erp",
            "type": "http"
        }
    }
}

文件位置 --把这个放进去 .vscode/mcp.json （VS代码/GitHub副本）， .cursor/mcp.json （光标）， .mcp.json （Claude Code/项目根），或者您的编辑器读取其MCP服务器配置的任何地方。

服务器 密钥 传输 身份验证
开发代理 aureus-dev-mcp-server stdio——通过 php artisan mcp:dev 无--本地进程
ERP代理 aureus-erp-mcp-server HTTP-- POST /mcp/erp OAuth承载令牌

Dev服务器作为子进程自动启动，不需要OAuth设置。ERP服务器使用正在运行的应用程序的URL通过HTTP连接；确保在使用前通过OAuth进行身份验证。

这与使用的模式相同 Laravel Boost (boost:mcp).

通过HTTP（ERP代理）与AI助手一起使用

问自然语言问题：

- "How many orders did we get this week?"
- "What is our total accounts receivable?"
- "Which products are low on stock?"
- "Show me our active projects"
- "What are the overdue invoices?"

通过stdio（开发代理）与编码代理一起使用

- "How do I create a new plugin?"
- "What routes does the Sales plugin expose?"
- "What are the fillable fields on the Order model?"
- "List all Filament resources for the Inventory plugin"
- "What API resource classes exist for accounts?"

使用MCP检查器

# Test Dev Agent server (stdio)
php artisan mcp:inspector aureuserp-dev

# Test Dev Agent server (HTTP)
php artisan mcp:inspector mcp/dev

# Test ERP Agent server (HTTP)
php artisan mcp:inspector mcp/erp

运输： streamable-http （HTTP）/ stdio （工匠）

相关 MCP