afferens

@afferens/mcp-server

适用于 Afferens 的 MCP 服务——为 AI Agent 提供实时物理感知。

可通过 stdio 在本地 MCP 客户端中使用，也可通过可流式传输的 HTTP 在远程/托管客户端中使用。它为任何兼容 MCP 的 AI 助手提供实时传感器数据：物体检测、位置、声音、环境读数、化学痕迹和节点运行状况。

工具

工具	身份验证	描述
afferens_demo	无	涵盖全部 6 种模态的实时感知数据。免费，无需密钥。
afferens_perceive	API 密钥	按模态查询实时事件，并进行筛选和限制结果数量。
afferens_verify	API 密钥	获取两次数据流，并返回包含标头、年龄和新鲜度判定的证明包。

模态： VISION / SPATIAL / ACOUSTIC / ENVIRONMENTAL / MOLECULAR / INTEROCEPTION

快速开始

免费套餐：10,000 个 token，无需信用卡。前往 afferens.com 获取密钥。

本地 MCP 客户端

claude mcp add afferens -- npx -y @afferens/mcp-server

然后设置密钥：

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

此 stdio 配置适用于 Claude Code、Claude Desktop、Cursor 和 Windsurf。

远程 MCP 客户端

对于托管或基于浏览器的客户端，请以 HTTP 模式运行 Afferens，并将客户端指向 /mcp 端点：

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

然后注册端点：

{
  "afferens": {
    "url": "http://127.0.0.1:8790/mcp",
    "bearer_token_env_var": "AFFERENS_API_KEY"
  }
}

Claude Desktop / Cursor / Windsurf

将以下内容添加到 MCP 配置文件中：

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

配置文件位置：

• Claude Desktop（Mac）：~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop（Windows）：%APPDATA%\Claude\claude_desktop_config.json
• Cursor：项目根目录中的 .cursor/mcp.json
• Windsurf：~/.codeium/windsurf/mcp_config.json

无需密钥即可试用

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

调用 afferens_demo——无需 API 密钥。

使用方法

连接后，AI Agent 可以调用：

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

返回结构化的感知事件，供 Agent 推理和采取行动。

验证演示：

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

返回两个原始快照以及标头、年龄和哈希校验，以便判断数据流是实时、过时还是未发生变化。

链接

• afferens.com - 注册、控制面板、API 文档
• npm
• Smithery

许可证

MIT