MOCO MCP Server

엔드포인트를 수동으로 정의하는 대신, 이 서버는 공식 MOCO OpenAPI 명세(openapi/ 디렉터리에 포함됨)와 전체 스키마 참조 파서를 사용하여 사용 가능한 모든 MCP 도구를 자동으로 생성합니다. 이를 통해 MCP 호환 LLM(예: Claude)은 정확한 도구 설명과 매개변수 스키마를 갖춘 MOCO API v1의 모든 읽기 및 쓰기 작업(GET, POST, PUT, DELETE)에 즉시 액세스할 수 있습니다.

Levelisteria GbR(운영자: Eddy Lackmann)이 개발하고 유지 관리합니다.

기능

• 전체 API 커버리지: Time Tracking, Projects, Invoices, Contacts 등 모든 MOCO 엔드포인트에 대한 도구를 자동으로 생성합니다.

• 안전 모드: 환경 변수를 통해 READ_ONLY로 제한하여 LLM이 의도치 않게 데이터를 수정하는 것을 방지할 수 있습니다.

• 항상 최신 유지: 서버가 시작될 때마다 MOCO에서 최신 API 명세를 가져옵니다.

• 간편한 실행: npx를 통해 바로 실행할 수 있습니다.

Related MCP server: Odoo MCP Server

사전 요구 사항

• Node.js (v24 이상)

• MOCO 계정 (<your-account>.mocoapp.com)

• MOCO API 키 (MOCO에서 Profile > Integrations에서 확인 가능)

빠른 시작 (npx)

네전역 설치 없이 서버를 직접 실행할 수 있습니다:

export MOCO_DOMAIN="your-account-name"
export MOCO_API_KEY="your-api-key"
npx -y @levisteria-solutions/moco-mcp-server

Claude Distop에서 설정

Claude Desktop 또는 Claude Code과 같은 MCP 설정에 서버를 추가합니다.

npx 사용 (로컬 사용에 권장)

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@levisteria-solutions/moco-mcp-server"],
      "env": {
        "MOCO_DOMAIN": "your-account-name",
        "MOCO_API_KEY": "your-api-key",
        "MOCO_READ_ONLY": "false"
      }
    }
  }
}

## Environment Variables

| Variable | Description | Example |
|----------|-------------|---------|
| `MOCO_DOMAIN` | Your MOCO subdomain (without `.mocoapp.com`) | `mycompany` |
| `MOCO_API_KEY` | Your personal or account API Key | `12345abcdef...` |
| `MOCO_READ_ONLY` | If `true`, only GET requests (reading) are allowed. POST/PUT/DELETE are blocked. | `true` or `false` |

## Development

1. Clone the repository:
```bash
git clone https://github.com/levisteria/moco-mcp-server.git
cd moco-mcp-server

2. 종속성 설치:

npm install

3. 프로젝트 빌드:

npm run build

4. 로컬에서 실행:

npm start

작동 방식

1. 서버는 openapi/ 디렉터리에 포함된 MOCO OpenAPI 명세를 로드합니다.

2. @apidevtools/swagger-parser를 사용하여 모든 $ref 링크를 역참조(dereference)하여 완전하고 정확한 JSON 스키마를 보장합니다.

3. 모든 경로(예: /activities)와 메서드(예: GET, POST)를 파싱하고 그 요약과 설명을 추출합니다.

4. 매개변수와 요청 본문을 MCP가 이해하는 JSON 스키마로 변환합니다.

5. 생성된 도구는 예: get_activities 또는 post_activities와 같이 이름이 지정됩니다.

6. LLM이 도구를 호출하면 서버는 인증된 요청을 MOCO에 전달하고 JSON 결과를 반환합니다.

라이선스

MIT License