Serveur MCP Arbiter
Commit 11 nov. 2026Fournit un pare-feu de capacités permettant aux agents IA d'interagir avec des services tels que SMTP et IMAP via un accès contrôlé par des politiques.
Aussi connu sous omry/arbiter
- Étoiles
- 3
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 11 nov. 2026
- Licence
- MIT
Qu'est-ce que Arbiter MCP ?
Fournit un pare-feu de capacités permettant aux agents IA d'interagir avec des services tels que SMTP et IMAP via un accès contrôlé par des politiques.
Résumé généré à partir du README du projet
À propos du MCP server Arbiter
Arbiter permet de sécuriser les interactions des agents IA avec les services de messagerie grâce à un pare-feu de capacités. Il offre un moyen contrôlé pour les agents d'accéder aux services SMTP et IMAP en utilisant des politiques de compte explicites. Cela empêche tout accès non restreint en garantissant que chaque action est régie par des règles et des métadonnées prédéfinies.
Les développeurs utilisent le serveur Arbiter via une API HTTP native et le gèrent à l'aide de la CLI arbiter-server. Le système prend en charge la soumission SMTP avec des identités d'expéditeur et des paramètres TLS configurés, ainsi que des outils IMAP pour la gestion des dossiers et des messages. Les utilisateurs peuvent interagir avec le service en cours d'exécution via la CLI client native d'arbiter ou en pointant des intégrations locales comme VS Code vers l'URL du serveur.
La configuration implique le bootstrapping des paramètres et la gestion des comptes de service via des objets spécialisés tels que arbiter.account et arbiter.policy. L'architecture prend en charge les déploiements Docker et permet un contrôle granulaire sur des opérations spécifiques telles que la recherche, le déplacement ou la suppression de messages IMAP au sein de dossiers limités.
Ce que vous pouvez faire avec
- 1Transmission d'e-mails contrôléeUn agent IA peut envoyer des e-mails avec des identités d'expéditeur spécifiques et des corps en HTML via une interface SMTP sécurisée.
- 2Interaction gérée avec la boîte de réceptionUn développeur peut autoriser un agent à rechercher, lire et organiser des e-mails dans des dossiers IMAP spécifiques.
- 3Accès aux services piloté par des politiquesLes administrateurs peuvent définir des règles d'accès strictes pour différents comptes de service en utilisant des objets de politique spécialisés.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
IMAP_PRIMARY_ACCOUNT_HOSTIMAP_PRIMARY_ACCOUNT_PASSWORDIMAP_PRIMARY_ACCOUNT_USERNAMESMTP_PRIMARY_ACCOUNT_HOSTSMTP_PRIMARY_ACCOUNT_PASSWORDSMTP_PRIMARY_ACCOUNT_USERNAME
| Nom | Description | Type |
|---|---|---|
| IMAP_PRIMARY_ACCOUNT_HOST | — | |
| IMAP_PRIMARY_ACCOUNT_PASSWORD | — | |
| IMAP_PRIMARY_ACCOUNT_USERNAME | — | |
| SMTP_PRIMARY_ACCOUNT_HOST | — | |
| SMTP_PRIMARY_ACCOUNT_PASSWORD | — | |
| SMTP_PRIMARY_ACCOUNT_USERNAME | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleomry/arbiter is public and reachablegithub.com/omry/arbiter ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-11github.com/omry/arbiter ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubArbiter
| Description | |
|---|---|
| Meta packages | |
| Core packages | |
| Plugins | |
| Python | |
| Docs, support, and ecosystem | |
| General |
Arbiter is a capability firewall between AI agents and services. Today it exposes policy-controlled access through an Arbiter server and client CLI; additional interfaces may be added later. The current service surface covers sending mail over SMTP and reading IMAP folders through explicit account policies.
Project Status
Current implementation status:
- Arbiter server over a native HTTP API
- capability discovery with SMTP and IMAP account and operation metadata
- SMTP submission with configured sender identity, TLS/auth settings, text/HTML bodies, and Bcc kept out of message headers
- IMAP list/get/search/move/mark-read/delete tools scoped to configured accounts and folders
arbiter.account.<service>and reusablearbiter.policy.<service>objects for per-service account policy- native
arbiterclient CLI andarbiter-serverserver/operator CLI - Reploy blueprint material for staged and installed Docker deployments
Known open gaps:
- durable audit storage is parked for post-v1, while startup/runtime logging is the v1 observability focus
- normalized error-code responses are still a design contract, while the implementation currently surfaces Python and transport errors
- the agent-facing skill integration path is intentionally not implemented in this repository yet
Development
Create and use the repo-local virtualenv with:
python3 -m venv .venv.venv/bin/python -m pip install --upgrade pip.venv/bin/python -m pip install -r requirements-dev.txt
The repository root is a workspace, not an Arbiter runtime package. The dev
requirements file installs server, plugins/smtp, and plugins/imap
editably so the arbiter-server command and service plugins come from this
checkout.
Install the native client separately when you need the repo-local arbiter
command:
.venv/bin/python -m pip install -e client
Run the test suite from the repo root with:
.venv/bin/python -m nox -s tests.venv/bin/python -m nox -s lint
The lint session runs both black --check and pyrefly check.
For focused local runs without nox, use the same environment directly, for example:
.venv/bin/python -m pytest server/tests/unit/test_config.py.venv/bin/python -m pytest server/tests/unit/test_app.py
GitHub Actions references
External actions use full commit SHAs with version comments. Reusable workflows
also use full SHAs, with one explicit exception: the two Node maintenance calls
in .github/workflows/dependency-audit.yml follow
hydra-ecosystem/github-actions@v1 for automatic compatible fixes. This trusts
the release tag maintained by that repository. A different source, workflow,
caller, branch, or major release requires a separate policy update. Full SHA
references remain valid for maintenance too. See the shared
release policy.
The Docusaurus website lives in website/:
cd website && npm installcd website && npm run startcd website && npm run build
The native client implementation lives in client/go-cli/. Build all default release targets from the repo root with:
tools/build_go_client --clean
This writes stripped Linux, macOS, and Windows binaries for amd64 and arm64
under client/go-cli/dist/. Limit the matrix with one or more --target GOOS-GOARCH arguments, for example tools/build_go_client --target linux-arm64; pass --debug to keep debug symbols.
Package the platform-neutral agent skill with:
tools/build_release_dists --packages skill
This writes the platform-neutral arbiter-skill wheel under dist/. The skill
declares arbiter-client as an Agent Skill Installer companion wheel; ASI lets
pip select the current platform's native client wheel during install.
The native client can also be packaged as the arbiter-client PyPI project:
tools/build_release_dists --packages client
This builds one platform-tagged wheel per native target. Each wheel installs the
native arbiter executable directly as a wheel script; it does not contain a
Python wrapper.
The user-facing documentation lives in website/docs/. The root docs/ directory contains internal planning, security assessments, active designs and an archive of superseded drafts:
- docs/BACKLOG.md
- docs/testing_backlog.md
- docs/release-readiness.md
- Security assessment
- docs/future/
- Historical designs
Local Native HTTP Run
For local Codex or VS Code integration, run Arbiter over native HTTPS and point the client at:
https://127.0.0.1:8075
Arbiter does not ship a runnable service config. Bootstrap a Hydra
config, edit it, then run the server. Keep server-owned files together in a
deployment directory; for local development, arbiter-server/conf is a useful
repository-local config directory.
Plugin-owned object templates are created by the plugin command surface:
arbiter-server --config-dir ./arbiter-server/conf bootstrap --server
arbiter-server --config-dir ./arbiter-server/conf bootstrap --plugin smtp --account primary
${oc.env:...} reads the process environment that your shell, supervisor,
container runtime, or secret manager provides. For local runs, the root config
can name one optional dotenv-style file to load before composition.
See website/docs/operate/configuration-model.md for the generated file layout and composition flow.
For local development, the server env file lives beside conf/:
# arbiter-server/.arbiter.env
SMTP_PRIMARY_ACCOUNT_HOST=smtp.example.com
# SMTP_PRIMARY_ACCOUNT_PORT=587
SMTP_PRIMARY_ACCOUNT_USERNAME=agent@example.com
SMTP_PRIMARY_ACCOUNT_PASSWORD=change-me
IMAP_PRIMARY_ACCOUNT_HOST=imap.example.com
# IMAP_PRIMARY_ACCOUNT_PORT=993
IMAP_PRIMARY_ACCOUNT_USERNAME=agent@example.com
IMAP_PRIMARY_ACCOUNT_PASSWORD=change-me
Point the root config at the env file:
arbiter:
env_file: ../.arbiter.env
Existing process environment variables take precedence over values from the env file. Relative paths are resolved from the config directory.
Build or refresh that file from the active config:
arbiter-server --config-dir ./arbiter-server/conf env bootstrap
arbiter-server --config-dir ./arbiter-server/conf env check
env bootstrap keeps existing assignments, adds missing config references, and
groups entries under sorted # arbiter-* blocks plus # miscellaneous.
If arbiter.env_file is not set yet, it adds arbiter.env_file: ../.arbiter.env to the root config first.
Then run from this directory:
arbiter-server --config-dir ./arbiter-server/conf config check
arbiter-server --config-dir ./arbiter-server/conf serve
config check and serve require at least one configured service account.
Use arbiter-server plugins list to inspect installed service plugins before
validating a config. Once the server is running, point the client CLI at the
server URL. The client accepts Arbiter's local self-signed TLS certificates by
default; configure arbiter.tls_ca_file when you want certificate verification
against a specific certificate authority file:
arbiter info server arbiter.url=https://127.0.0.1:8075
arbiter plugins arbiter.url=https://127.0.0.1:8075
The client can also read the endpoint from a small config file:
~/.arbiter/arbiter-client.yaml.
arbiter:
url: https://127.0.0.1:8075
Override config values with Hydra-style key=value arguments after the
command, or bootstrap the client config:
arbiter bootstrap client arbiter.url=https://127.0.0.1:8075
IMAP operations use folder-scoped UIDs returned by imap:list_messages and
imap:search_messages; pass those ids back to imap:get_message,
imap:move_message, imap:mark_message_read, or imap:delete_message with
the same account and folder.
License
Arbiter is distributed under the MIT License. See LICENSE.
Questions sur Arbiter MCP
Quels services Arbiter prend-il en charge actuellement ?
La surface de service actuelle inclut l'envoi de courriels via SMTP et la lecture de dossiers IMAP grâce à des politiques de compte explicites.
Arbiter propose-t-il un stockage d'audit ?
Le stockage d'audit durable est actuellement reporté après la v1, mais l'accent est mis sur la journalisation au démarrage et au runtime pour l'observabilité de la v1.