MCP Perfex Crm MCP 服务器 | PlugMCP
跳到正文 MCP Perfex CRM - High-Performance MCP Server for Perfex CRM
🎯 Overview
High-Performance MCP Server for Perfex CRM with direct MySQL access and 30+ tools
把任意工具接入任意智能体。面向非开发者的 MCP 服务器目录;网关承载流量,n8n 承载应用。
产品
目录
开发者
公司
MCP Perfex CRM is a high-performance Model Context Protocol (MCP) server that provides direct and optimized access to Perfex CRM's MySQL database. This project offers a high-performance alternative to traditional REST APIs, with focus on code quality, security, and maintainability.
✅ Current Status - v1.0.0-stable
14 functional modules with 186+ tested tools covering comprehensive Perfex CRM functionality
Zero warnings in ESLint and TypeScript
Complete CI/CD with GitHub Actions
Robust type system implemented
Complete API documentation
🚀 Features
🔥 Performance : Direct MySQL access, 10-100x faster than REST API
🛡️ Security : Prepared statements, input validation, read-only connections
📊 Modular : Extensible architecture with independent modules
🧪 Tested : Jest testing framework with growing coverage
📝 Documented : Complete API documentation with examples
🔄 CI/CD : Automated pipeline with quality gates
📦 Available Modules
Core (100% Functional)
Customers - Complete customer management
Estimates - Estimates and proposals
Invoices - Complete invoice management with payments and statistics (8 tools)
Leads - Lead management, conversion, and lifecycle tracking (9 tools)
Projects - Project management
Tasks - Task control
Contracts - Contract management
Payments - Payment processing
Expenses - Expense control
Tickets - Complete support system with delete/export tools
Reporting
Financial Reporting - Advanced financial reports
Resource Management - Resource management
Timesheets - Time tracking
Utilities
Subscriptions - Subscription management
Credit Notes - Credit notes
🛠️ Installation
Option 1: NPM Installation (Recommended) npm install -g mcp-perfex-crm
Option 2: Local Installation # Clone repository
git clone https://github.com/YOUR_USERNAME/mcp-perfex-crm
cd mcp-perfex-crm
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your MySQL settings
# Compile project
npm run build
# Run tests
npm test
⚙️ Configuration
1. Database Configuration # .env
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=perfex_readonly
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=perfex_crm
# Log optimization for production
LOG_LEVEL=error
NODE_ENV=production
ENABLE_AUDIT_LOG=false
2. N8N Integration MCP Perfex CRM is fully compatible with N8N for workflow automation:
# Install as N8N tool
npm install -g mcp-perfex-crm
# Or use in N8N Docker
FROM n8nio/n8n:latest
RUN npm install -g mcp-perfex-crm
{
"nodes": [
{
"parameters": {
"command": "mcp-perfex-crm",
"options": {
"env": {
"MYSQL_HOST": "your-db-host",
"MYSQL_USER": "readonly_user",
"MYSQL_PASSWORD": "secure_password",
"MYSQL_DATABASE": "perfex_crm"
}
}
},
"type": "@n8n/n8n-nodes-langchain.toolWorkflow",
"position": [250, 300],
"id": "perfex-crm-tool"
}
]
}
3. Claude Desktop Integration {
"mcpServers": {
"mcp-perfex-crm": {
"command": "mcp-perfex-crm",
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "perfex_readonly",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "perfex_crm"
}
}
}
}
{
"mcpServers": {
"mcp-perfex-crm": {
"command": "node",
"args": ["/path/to/mcp-perfex-crm/dist/index.js"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "perfex_readonly",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "perfex_crm"
}
}
}
}
📖 Usage
Example: List Customers // Via MCP
const result = await use_mcp_tool({
server_name: "mcp-perfex-crm",
tool_name: "get_customers",
arguments: {
limit: 10,
active: true
}
});
Example: Create Project const result = await use_mcp_tool({
server_name: "mcp-perfex-crm",
tool_name: "create_project",
arguments: {
name: "New Website",
client_id: 123,
start_date: "2025-02-01",
billing_type: "fixed_rate",
project_cost: 5000
}
});
🧪 Development # Development mode with hot reload
npm run dev
# Run linter
npm run lint
# Format code
npm run format
# Run tests with coverage
npm run test:coverage
# Production build
npm run build
📊 Code Quality
✅ TypeScript : Robust type system
✅ ESLint : Zero warnings, strict configuration
✅ Prettier : Consistent formatting
✅ Jest : Configured testing framework
✅ GitHub Actions : Automated CI/CD
✅ Optimized Logging : Production configuration with minimal context impact
🔒 Security
All queries use prepared statements
Input validation on all tools
Read-only connections by default
Audit logs for sensitive operations
Masks for sensitive data in logs
🤝 Contributing Contributions are welcome! Please:
Fork the project
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request
Code Standards
Follow the configured TypeScript/ESLint style
Add tests for new functionality
Keep documentation updated
Zero warnings is mandatory
📈 Roadmap
v1.0.1 (February 2025)
v1.1.0 (Q1 2025)
v1.2.0 (Q2 2025)
📝 Documentation
📄 License This project is licensed under the MIT License - see the LICENSE file for details.
👨💻 Author
🙏 Acknowledgments
Anthropic team for the Model Context Protocol
Perfex CRM community
All contributors
📊 Performance Benchmarks
🏗️ Architecture mcp-perfex-crm/
├── src/
│ ├── modules/ # Business logic modules
│ ├── tools/ # MCP tools implementation
│ ├── types/ # TypeScript definitions
│ ├── utils/ # Utility functions
│ └── connections/ # Database connections
├── tests/ # Test suites
├── docs/ # Documentation
└── examples/ # Usage examples
⭐ If this project helped you, please consider giving it a star!
🚀 Ready to supercharge your Perfex CRM integration? Get started now!
Graphify Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, e Private Gpt Complete API layer for private AI applications on local models: RAG, skills, tools, MCP, text-to-sql, and more. Works with any OpenAI-compatible inference server. Scientific Agent Skills Turn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 250,000+ scientists worldwide. 177 ready-to-use validated skills plus 100+ scientific databases covering biolog Open Code Review Secure, fast, efficient, battle-tested at Alibaba's scale. Hybrid architecture code review tool: deterministic pipelines + LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, Codebase Memory Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection. Orm The Prisma ORM: write your application in TypeScript with human-readable queries instead of SQL. Host your database on Prisma Postgres and your app on Prisma Compute. OpenViking Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills. Context Mode Free, local plugin that keeps tool output out of your coding agent's context window. Sandbox and SQLite FTS5 search, 99% fewer bytes in context. Works with Claude Code, Codex, Pi, OMP, OpenCode, Gemin Dbx 25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Dock Xerj AI search engine and MCP server for bots and agents. One Rust binary indexes code, docs, logs, JSONL/CSV and PDFs for BM25 full-text, vector and hybrid search, code search without grep, agent memory a Wasp The batteries-included full-stack framework for the AI era. Develop JS/TS web apps (React, Node.js, and Prisma) using declarative code that abstracts away complex full-stack features like auth, backgr WrenAI GenBI (Generative BI) for AI agents, an open-source, governed text-to-SQL through an open context layer that turns natural-language questions into trusted dashboards, charts, and SQL across 20+ data s Databases MCP 服务器 最佳 Databases MCP 服务器
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
如何安装 MCP Perfex Crm? 在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
MCP Perfex Crm 需要 API 密钥吗? 此记录未列出必需的环境变量。
MCP Perfex Crm 使用哪种传输方式? MCP Perfex Crm 通过 stdio 在本地运行。
MCP Perfex Crm 上次检查是什么时候? 上次检查时间:2026-10-27。 High-Performance MCP Server for Perfex CRM with direct MySQL access and 30+ tools
工具
0 / 10