Ectlocal Connect MCP Server

EC 솔루션의 PostgreSQL 데이터베이스에 접속하여 주문, 회원 등 이커머스 데이터를 조회하고 관리할 수 있는 MCP(Model Context Protocol) 서버입니다.

기능

PostgreSQL 데이터베이스 연결 및 쿼리 실행
테이블 구조 및 통계 정보 조회
주문 정보 조회 (기본/상세)
회원 정보 조회
전체 테이블 목록 조회

설치 및 설정

1. 의존성 설치

npm install

2. 환경 변수 설정

.env.example 파일을 복사하여 .env 파일을 생성하고 데이터베이스 비밀번호를 설정합니다:

cp .env.example .env
# .env 파일에서 ECTLOCAL_DB_PASSWORD 설정

3. 빌드

npm run build

사용법

개발 모드

npm run dev

프로덕션 모드

npm start

MCP 도구

1. execute_query

SQL 쿼리를 직접 실행합니다.

매개변수:

query (string): 실행할 SQL 쿼리

예시:

SELECT COUNT(*) FROM orders WHERE order_date >= '2025-01-01'

2. get_table_structure

테이블의 구조, 인덱스, 통계 정보를 조회합니다.

매개변수:

table_name (string): 조회할 테이블 이름

예시:

table_name: orders

3. list_tables

ec_ectlocal 스키마의 모든 테이블 목록을 조회합니다.

매개변수: 없음

4. get_order

특정 주문 ID로 주문 정보를 조회합니다.

매개변수:

order_id (string): 조회할 주문 ID

예시:

order_id: 20250804-0000020

5. get_order_detail

주문 상세 정보를 order_manage 테이블과 함께 조회합니다.

매개변수:

order_id (string): 조회할 주문 ID

6. get_member

회원 ID로 회원 정보를 조회합니다.

매개변수:

member_id (string): 조회할 회원 ID

예시:

member_id: ectlocal

Claude Desktop 설정

Claude Desktop에서 이 MCP 서버를 사용하려면 설정 파일에 다음을 추가하세요:

옵션 1: .env 파일 자동 로딩 (권장)

MCP 서버가 프로젝트 루트의 .env 파일을 자동으로 찾아 로딩합니다.

macOS - ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ectlocal-connect": {
      "command": "node",
      "args": ["/Users/wjsong/Workspace/MCP/ectlocal-connect/dist/index.js"]
    }
  }
}

Windows - %APPDATA%/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ectlocal-connect": {
      "command": "node",
      "args": ["C:\\Users\\wjsong\\Workspace\\MCP\\ectlocal-connect\\dist\\index.js"]
    }
  }
}

옵션 2: 환경변수 직접 설정

Claude Desktop 설정에서 직접 환경변수를 설정합니다.

macOS:

{
  "mcpServers": {
    "ectlocal-connect": {
      "command": "node",
      "args": ["/Users/wjsong/Workspace/MCP/ectlocal-connect/dist/index.js"]
    }
  }
}

데이터베이스 정보

Host: your_db_host
Port: your_db_pord
Database: your_database
Schema: your_schema
User: db_user

주요 테이블

orders: 주문 정보
order_manage: 주문 관리 정보
member: 회원 정보

개발

스크립트

npm run build: TypeScript 컴파일
npm run dev: 개발 모드 실행
npm start: 프로덕션 모드 실행

의존성

@modelcontextprotocol/sdk: MCP SDK
pg: PostgreSQL 클라이언트
dotenv: 환경 변수 관리
typescript: TypeScript 컴파일러
tsx: TypeScript 실행기

MCP 서버 실행 방법

npm install && npm run build && npm start

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables connection to PostgreSQL databases for EC solution platforms to query and manage e-commerce data including orders, members, and other business information. Provides tools for direct SQL execution, table structure analysis, and specialized e-commerce data retrieval functions.

Related MCP Servers

PostgreSQL MCP Server
nahmanmate
A
security
A
license
A
quality
Facilitates management and optimization of PostgreSQL databases, offering analysis, setup guidance, and debugging, while ensuring secure and efficient database operations.
Last updated -
3
0
16
TypeScript
AGPL 3.0
PostgreSQL MCP Server
DanielRSnell
-
security
F
license
-
quality
Provides read-only access to PostgreSQL databases, enabling LLMs to inspect database schemas and execute read-only SQL queries within a secure transaction context.
Last updated -
21,436
1
JavaScript
MCP PostgreSQL Server
Maxim2324
A
security
A
license
A
quality
A server that connects to PostgreSQL databases and provides tools for safely exploring schemas, running read-only SQL queries, and performing data analysis with pre-built templates.
Last updated -
5
693
1
JavaScript
MIT License
MCP Database Server
JuanYin1
-
security
A
license
-
quality
Provides Claude with direct access to databases including SQLite, SQL Server, PostgreSQL, and MySQL, enabling execution of SQL queries and table management through natural language.
Last updated -
579
1
TypeScript
MIT License

View all related MCP servers

Ectlocal Connect MCP Server