Arnakoff MCP server
2026년 11월 12일 커밋AI 클라이언트가 웹사이트, 이메일, 전화번호, IBAN 또는 SIREN 번호를 사기 방지 소스 및 블랙리스트와 대조하여 검증할 수 있도록 합니다.
다른 이름 arnakoff/api, api
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 11월 12일
- 라이선스
- AGPL-3.0
Arnakoff MCP란?
Arnakoff은(는) MCP server입니다. AI 클라이언트가 웹사이트, 이메일, 전화번호, IBAN 또는 SIREN 번호를 사기 방지 소스 및 블랙리스트와 대조하여 검증할 수 있도록 합니다.
프로젝트 README에서 생성된 요약
Arnakoff MCP server 정보
Arnakoff는 개발자와 AI 클라이언트가 특정 식별자와 관련된 잠재적 위험을 식별할 수 있도록 설계된 사기 방지 검증 서비스를 제공합니다. 웹사이트, 이메일 주소, 전화번호, IBAN 또는 SIREN 번호를 공개 블랙리스트 및 공식 등록부와 대조하여, 서버는 단정적인 비난 대신 사실에 기반한 신호를 반환합니다. AMF 및 ACPR 블랙리스트, SIRENE 디렉토리, ARCEP 번호 체계와 같은 소스를 교차 참조하여 프랑스 현지 맥락에 맞는 정보를 제공합니다.
사용자는 POST 요청을 통해 원격 MCP server로 이 서비스를 통합하거나, cmd/mcp 명령어를 사용하여 stdio 방식으로 로컬에서 실행할 수 있습니다. 사용을 위해서는 이메일 요청 프로세스를 통해 발급받은 무료 API 키가 필요합니다. 이 시스템은 이메일 및 IBAN과 같은 개인 데이터가 평문으로 로그에 남거나 제3자와 공유되지 않도록 보장하여 개인정보 보호를 최우선으로 합니다. 또한 동기화 과정에서 데이터 유실이 크게 발생하는 소스 스냅샷을 거부함으로써 높은 데이터 무결성을 유지합니다.
활용 사례
- 1비즈니스 적법성 검증기업의 SIREN 번호가 유효한지, 그리고 프랑스 공식 등록부에서 인정되는지 확인합니다.
- 2사기 웹사이트 탐지도메인이 금융 당국 블랙리스트에 등록되어 있는지 또는 의심스러운 생성 시기를 가졌는지 식별합니다.
- 3금융 식별자 스크리닝사용자 개인정보를 침해하지 않으면서 알려진 사기 신호를 바탕으로 IBAN을 검증합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Arnakoff MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Arnakoff MCP 설치
$ claude mcp add --transport http api https://api.arnakoff.com/mcpCursor에 Arnakoff MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://api.arnakoff.com/mcp"
}
}
}VS Code에 Arnakoff MCP 설치
.vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://api.arnakoff.com/mcp"
}
}
}VS Code CLI에 Arnakoff MCP 설치
$ code --add-mcp '{"name":"api","type":"http","url":"https://api.arnakoff.com/mcp"}'Codex에 Arnakoff MCP 설치
$ codex mcp add api --url https://api.arnakoff.com/mcpCodex config.toml에 Arnakoff MCP 설치
~/.codex/config.toml
[mcp_servers.api] url = "https://api.arnakoff.com/mcp"
Gemini CLI에 Arnakoff MCP 설치
$ gemini mcp add -s user --transport http api https://api.arnakoff.com/mcpGemini settings.json에 Arnakoff MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"api": {
"url": "https://api.arnakoff.com/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능arnakoff/api is public and reachablegithub.com/arnakoff/api ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-12github.com/arnakoff/api ↗통과
- OpenSSF ScorecardOpenSSF Scorecard 7.4 / 10; weakest: Code-Review 0, Maintained 0, CII-Best-Practices 0scorecard.dev/viewer/?uri=github.com/arnakoff/api ↗통과
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기Arnakoff API
API publique anti-arnaque : pour un site, un e-mail, un numéro de téléphone, un IBAN ou un SIREN, elle renvoie des signaux sourcés expliqués en français.
Statut
En service depuis le 06/11/2026, version 1.0.0 : https://api.arnakoff.com. Le contrat (api/openapi.yaml) est stable : un changement cassant passera par une nouvelle version majeure ou par une dépréciation annoncée (Deprecation, Sunset). La clé est gratuite et s'obtient par un lien de connexion envoyé par e-mail (POST /v1/keys/request) ; la page du site qui la demande n'est pas encore en ligne. Suis la suite dans la feuille de route.
Ce que fait l'API
Tu lui donnes une entrée ; elle la confronte à des sources publiques (listes noires de l'AMF et de l'ACPR, répertoire SIRENE, BODACC, âge du domaine, numérotation de l'ARCEP…) et renvoie une liste de signaux. Chaque signal porte :
code: identifiant stable du signal ;level: niveau du signal ;message: une phrase factuelle en français, par exemple « Figure sur la liste noire de l'AMF depuis le 08/10/2026 » ;sourceetsource_url: l'éditeur de la donnée et où la vérifier ;observed_at: la date à laquelle la donnée a été relevée.
Les signaux prévus sont dans docs/signals.md, les sources et leurs licences dans docs/sources.md. L'API est aussi exposée comme serveur MCP : à distance sur POST /mcp, avec la même clé et le même quota que /v1/check, ou en local avec cmd/mcp (stdio). Il figure dans le registre MCP officiel sous le nom com.arnakoff/api.
Principes
- Jamais « sûr ». Sans signal, la réponse est « Aucun signal connu dans nos sources » : l'absence d'une liste noire ne prouve rien.
- Des faits, pas des accusations. Chaque signal cite sa source ; aucun message ne qualifie une entité nommée d'arnaque.
- Des licences d'abord. Une source n'est utilisée que si sa licence autorise la réutilisation commerciale.
- Les données personnelles protégées. Les e-mails, numéros et IBAN ne sont jamais journalisés en clair ni transmis à un tiers.
- Aucune URL fournie par l'utilisateur n'est appelée. Les registres sont interrogés par identifiant, à travers une liste d'hôtes autorisés.
- Une synchronisation prudente. Un instantané de source invalide, ou qui perd plus de 20 % de ses entrées, est rejeté ; le précédent reste en service.
Démarrer
Il te faut Go 1.27 : la version exacte (toolchain go1.27.3) est dans go.mod et se télécharge d'elle-même. Installe aussi golangci-lint à la version indiquée dans docs/standards.md.
go build ./...
go vet ./...
golangci-lint run
go test -race -shuffle=on ./...
go tool govulncheck ./... tool
La CI lance les mêmes commandes sur chaque pull request. Les tests n'utilisent jamais le réseau.
Avec Docker, l'image (Dockerfile) contient les commandes api, sync et admin sur une base distroless sans shell, exécutées par un utilisateur non root. compose.yaml lance l'API et la synchronisation, qui partagent le volume des instantanés :
cp .env.example .env # renseigner ARNAKOFF_LOG_KEY, ARNAKOFF_DATABASE_URL et ARNAKOFF_API_KEY_SECRET
docker compose up --build
Chaque version publiée (tag vX.Y.Z) produit l'image ghcr.io/arnakoff/api pour linux/amd64 et linux/arm64, taguée X.Y.Z, X.Y et latest, avec son SBOM et son attestation de provenance. Elle est signée sans clé par cosign depuis le workflow image.yml ; pour vérifier la signature d'une version (ici 0.48.0) :
cosign verify ghcr.io/arnakoff/api:0.48.0 \
--certificate-identity https://github.com/arnakoff/api/.github/workflows/image.yml@refs/tags/v0.48.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
Le SBOM et la provenance se lisent avec docker buildx imagetools inspect ghcr.io/arnakoff/api:0.48.0 --format '{{ json .SBOM.SPDX }}' (ou '{{ json .Provenance.SLSA }}').
Organisation
Architecture propre (ADR 0002) : les dépendances vont vers l'intérieur uniquement.
| Dossier | Rôle |
|---|---|
internal/domain/ |
Objets métier, normalisation des entrées et règles des signaux, sans entrée-sortie. |
internal/app/ |
Cas d'usage (vérification, synchronisation) et interfaces dont ils ont besoin. |
internal/adapter/ |
Sources, registres, stockage, API HTTP et serveur MCP. |
internal/platform/ |
Client HTTP sortant, journaux, configuration. |
cmd/ |
Points d'entrée : api, sync, mcp et eval. |
Documentation
- Décisions d'architecture : 0001 — Socle technique, 0002 — Architecture propre, 0003 — Licences, 0004 — Stockage des clés et des quotas, 0005 — Hébergement de production, 0006 — Durées de conservation, 0007 — Rotation automatique des clés, 0008 — Offres, prix et quotas.
- Standards et versions, sources, signaux.
- Le site et la documentation publique de l'API sont dans
arnakoff/web.
Contribuer
Lis CONTRIBUTING.md. Pour une faille de sécurité, suis la politique de sécurité, jamais une issue publique. Pour de l'aide, vois SUPPORT.md.
Licence
Le code est sous GNU AGPL-3.0-only (ADR 0003). Les données gardent la licence de leur source, indiquée dans docs/sources.md.
Arnakoff MCP 질문
Arnakoff MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http api https://api.arnakoff.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Arnakoff MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Arnakoff API로 무엇을 검증할 수 있나요?
웹사이트, 이메일, 전화번호, IBAN 또는 SIREN 번호의 사기 방지 신호를 확인할 수 있습니다.
신호가 발견되지 않으면 해당 소스가 안전하다는 뜻인가요?
아니요, 블랙리스트에서 신호가 발견되지 않는다고 해서 안전함이 증명되는 것은 아닙니다. 시스템은 결코 '확신'하지 않습니다.
API 키는 어떻게 받나요?
키는 무료이며, POST /v1/keys/request 엔드포인트를 통해 이메일로 전송되는 로그인 링크를 통해 받을 수 있습니다.
개인 정보가 보호되나요?
네, 이메일, 전화번호, IBAN은 평문으로 로그에 남지 않으며 제3자에게 전송되지 않습니다.