nei-mcp-server

NEI 플랫폼과 상호 작용하여 NEI 프로젝트 리소스를 쿼리할 수 있는 fastmcp 기반 도구 서버입니다.

핵심 기능

본 프로젝트는 NEI 플랫폼의 일반적인 기능을 일련의 MCP 도구로 캡슐화하여 빠른 쿼리 및 통합을 지원합니다. 지원되는 도구는 다음과 같습니다:

• sync_nei_project: 원격 NEI 플랫폼에서 최신 프로젝트 데이터를 강제로 동기화하고 로컬 캐시를 업데이트합니다. 로컬 데이터가 최신이 아니라고 의심되거나 최근 변경된 백엔드 인터페이스, 데이터 모델 정보를 가져와야 할 때 이 도구를 먼저 호출해야 합니다.

• search_interfaces_by_uri: 인터페이스 정의 URI(인터페이스 경로)를 기반으로 NEI 프로젝트 내의 인터페이스 리소스를 퍼지 검색합니다.

• search_interfaces_by_url: NEI 인터페이스 상세 링크의 pid 및 id를 기반으로 인터페이스 리소스를 정확하게 검색합니다 (예: http://nei.example.com/interface/detail/?pid=10135&id=13015).

• search_interfaces_by_name: 인터페이스 이름을 기반으로 NEI 프로젝트 내의 인터페이스 리소스를 퍼지 검색합니다.

• search_groups_by_name: 그룹 이름을 기반으로 NEI 프로젝트 내의 비즈니스 그룹을 검색합니다.

Related MCP server: Nexus MCP Server

환경 준비

• Node.js (v20 이상 권장)

• pnpm (선택 사항, 권장)

설치 및 구성

1. 프로젝트 복제

   git clone https://github.com/leila-huang/nei-mcp-server.git
   cd nei-mcp-server

2. 의존성 설치 npm 사용:

   npm install

   또는 pnpm 사용:

   pnpm install

디버깅 도구

1. inspect 디버깅 fastmcp의 inspect 명령을 사용하면 로컬에서 대화형으로 모든 도구를 쉽게 테스트할 수 있습니다. 웹 페이지에서 SERVER_URL 및 PROJECT_ID를 구성해야 합니다.

   npm run inspect

   이 명령은 실행할 도구를 선택하고 매개변수를 입력할 수 있는 대화형 인터페이스를 제공하므로 디버깅 및 탐색에 매우 적합합니다.

2. mcp 클라이언트 디버깅

       {
         "mcpServers": {
             "nei-mcp-server": {
                 "command": "npx",
                 "args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
                 "env": {
                     "SERVER_URL": "xxx",
                     "PROJECT_ID": "xxx"
                 }
             }
         }
       }

mcp 사용 가이드

```bash
{
    "mcpServers": {
        "nei-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@leila329/nei-mcp-server"
            ],
            "env": {
                "SERVER_URL": "xxx",
                "PROJECT_ID": "xxx"
            }
        }
    }
}
```

캐싱 메커니즘

성능을 향상하고 NEI 서버에 대한 요청 부하를 줄이기 위해 본 프로젝트는 간단한 캐싱 전략을 구현했습니다:

1. 메모리 캐시: 데이터는 처음 로드된 후 메모리에 저장됩니다. 서비스가 실행되는 동안 동일한 요청이 발생하면 네트워크 요청을 반복하지 않고 메모리에서 직접 반환합니다. 서비스가 재시작되면 메모리 캐시는 비워집니다.

2. 네트워크 동기화: 서비스가 시작될 때 또는 sync_nei_project 도구를 수동으로 호출할 때 NEI 원격 서버에서 최신 프로젝트 데이터를 가져와 메모리 캐시를 업데이트합니다.

sync_nei_project 도구를 호출하여 네트워크 동기화를 수동으로 강제 실행함으로써 데이터가 최신 버전인지 확인할 수 있습니다.