English Français العربية

io.github.afferens/mcp-server

Registre officiel IA et agents

Real-time physical perception for AI agents — vision, spatial, acoustic, environmental

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @afferens/mcp-server
Claude Code 
claude mcp add io-github-afferens-mcp-server -- npx -y @afferens/mcp-server@0.2.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-afferens-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@afferens/mcp-server@0.2.1"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @afferens/mcp-server
  2. Tools
  3. Quick Start
  4. Usage
  5. Links
  6. License

@afferens/mcp-server

MCP server for Afferens - real-time physical perception for AI agents.

Use it from local MCP clients over stdio or remote/hosted clients over streamable HTTP. It gives any MCP-compatible AI assistant live sensor data: object detections, positions, sounds, environmental readings, chemical traces, and node health.

Tools

ToolAuthDescription
afferens_demoNoneLive perception data across all 6 modalities. Free, no key needed.
afferens_perceiveAPI keyQuery live events by modality with filtering and limits.
afferens_verifyAPI keyFetch the feed twice and return a proof bundle with headers, age, and a freshness verdict.

Modalities: VISION / SPATIAL / ACOUSTIC / ENVIRONMENTAL / MOLECULAR / INTEROCEPTION

Quick Start

Free tier: 10,000 tokens, no card required. Get your key at afferens.com.

Local MCP Clients
claude mcp add afferens -- npx -y @afferens/mcp-server

Then set your key:

claude mcp add afferens -e AFFERENS_API_KEY=YOUR_KEY -- npx -y @afferens/mcp-server

This stdio setup works for Claude Code, Claude Desktop, Cursor, and Windsurf.

Remote MCP Clients

For hosted or browser-based clients, run Afferens in HTTP mode and point the client at the /mcp endpoint:

AFFERENS_TRANSPORT=http AFFERENS_PORT=8790 AFFERENS_API_KEY=YOUR_KEY node dist/index.js

Then register the endpoint:

{
  "afferens": {
    "url": "http://127.0.0.1:8790/mcp",
    "bearer_token_env_var": "AFFERENS_API_KEY"
  }
}
Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

{
  "mcpServers": {
    "afferens": {
      "command": "npx",
      "args": ["-y", "@afferens/mcp-server"],
      "env": {
        "AFFERENS_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Config file locations:

  • Claude Desktop (Mac): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
  • Cursor: .cursor/mcp.json in your project root
  • Windsurf: ~/.codeium/windsurf/mcp_config.json
Try it without a key
{
  "mcpServers": {
    "afferens": {
      "command": "npx",
      "args": ["-y", "@afferens/mcp-server"]
    }
  }
}

Call afferens_demo - no API key needed.

Usage

Once connected, your AI agent can call:

afferens_perceive({ modality: "VISION", limit: 5 })

Returns structured perception events your agent can reason over and act on.

For demo verification:

afferens_verify({ modality: "VISION", limit: 3, wait_ms: 2000 })

Returns two raw snapshots plus headers, age, and a hash check so you can show whether the feed is live, stale, or unchanged.

License

MIT

Questions fréquentes

Qu'est-ce que io.github.afferens/mcp-server ?

Real-time physical perception for AI agents — vision, spatial, acoustic, environmental

Comment installer io.github.afferens/mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add io-github-afferens-mcp-server -- npx -y @afferens/mcp-server@0.2.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.afferens/mcp-server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.afferens/mcp-server est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.afferens/mcp-server ?

Il est publié par afferens. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.