采购管理协议服务器

npx -y @procurementexpress.com/mcp

{
  "mcpServers": {
    "procurementexpress": {
      "command": "npx",
      "args": ["-y", "@procurementexpress.com/mcp"],
      "env": {
        "PROCUREMENTEXPRESS_API_VERSION": "v1",
        "PROCUREMENTEXPRESS_AUTH_TOKEN": "your_token",
        "PROCUREMENTEXPRESS_COMPANY_ID": "your_company_id"
      }
    }
  }
}

{
  "mcpServers": {
    "procurementexpress": {
      "command": "npx",
      "args": ["-y", "@procurementexpress.com/mcp"],
      "env": {
        "PROCUREMENTEXPRESS_API_VERSION": "v1",
        "PROCUREMENTEXPRESS_AUTH_TOKEN": "your_token",
        "PROCUREMENTEXPRESS_COMPANY_ID": "your_company_id"
      }
    }
  }
}

# From your project root
mkdir -p .claude/skills

# Copy all PEX skills from the package
cp -r node_modules/@procurementexpress.com/mcp/.claude/skills/pex-* .claude/skills/

# Example: only purchase orders and invoices
cp -r node_modules/@procurementexpress.com/mcp/.claude/skills/pex-purchase-orders .claude/skills/
cp -r node_modules/@procurementexpress.com/mcp/.claude/skills/pex-invoices .claude/skills/

src/
  index.ts              # Entry point — MCP server setup, auth tools, tool registration
  api-client.ts         # HTTP client with versioned path building, auth headers, multipart support
  auth.ts               # Dual auth manager (V1 token / V3 OAuth2)
  tool-helpers.ts       # Shared response helpers and error handling wrapper
  types.ts              # TypeScript interfaces for all API entities
  schemas.ts            # Shared Zod schemas (custom field values, line items, nested attributes)
  tools/
    approval-flows.ts   # Approval flow CRUD, publish/unpublish, runs, versions, rerun
    budgets.ts          # Budget CRUD
    chat-messages.ts    # Chat messages (V3 only) — list, create, delete
    comments.ts         # PO and invoice comments
    companies.ts        # Company details, employees, approvers, invitations, pending invites
    compliance.ts       # Compliance checks, bulk checks, justifications, memos, evidence packs
    custom-fields.ts    # Custom field CRUD + position reordering
    departments.ts      # Department CRUD
    digital-invoices.ts # Digital invoice creation from scanned documents
    invoices.ts         # Invoice CRUD, approve/reject/cancel/archive, rerun approval, PO linking
    payments.ts         # Payment creation (standalone, PO-linked, NPayment) and get
    policies.ts         # Policy CRUD + policy templates
    products.ts         # Product CRUD + bulk create + SKU listing
    purchase-orders.ts  # PO CRUD, approve/reject/cancel/archive/delete, delivery, PDF, bulk save
    supplementary.ts    # Chart of accounts, QBO integration, email forwarding
    suppliers.ts        # Supplier CRUD + top suppliers + SAM.gov check + supplier approvals
    tax-rates.ts        # Tax rate CRUD
    uploads.ts          # File uploads (PO attachments, comment files, upload status)
    users.ts            # Current user profile and currency listing
    webhooks.ts         # Webhook CRUD + delete
tests/
  e2e/
    setup.ts            # MockApiServer with version-agnostic route registration
    *.test.ts           # E2E tests for each tool group (211 tests)

git clone https://github.com/przbadu/procurementexpress-mcp.git
cd procurementexpress-mcp
npm install

npm run build      # Compile TypeScript to dist/
npm run dev        # Watch mode for development

npm test                                    # Run all tests
npm run test:e2e                            # Run E2E tests only
npx vitest run tests/e2e/auth.test.ts       # Run a single test file
npm run test:watch                          # Watch mode

import { z } from "zod";
import type { ApiClient } from "../api-client.js";
import type { Server } from "../tool-helpers.js";
import { jsonResponse, withErrorHandling } from "../tool-helpers.js";

export function registerMyTools(server: Server, apiClient: ApiClient): void {
  server.registerTool(
    "my_tool_name",
    {
      description: "What this tool does",
      inputSchema: {
        id: z.number().int().positive().describe("Resource ID"),
      },
    },
    withErrorHandling(async (args) => {
      const result = await apiClient.get(apiClient.buildPath(`/my_resource/${args.id}`));
      return jsonResponse(result);
    }),
  );
}

import { registerMyTools } from "./tools/my-tools.js";
registerMyTools(server, apiClient);