Afferens

io.github.afferens由 GitHub 账号 afferens 发布v0.2.1更新于 Oct 24, 2026

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

已验证STDIO仅桌面数据与分析AI 与机器学习

概览

AI 生成的概览

Afferens 是一个本地 MCP 服务器,为 AI 助手提供实时物理感知数据:视觉、空间、声音、环境、分子与节点健康。

可以做什么
按模态(视觉、空间、声音、环境、分子、内感受)查询实时感知事件,支持过滤和数量限制,需 API 密钥。无需密钥即可获取覆盖全部六种模态的演示数据。通过两次抓取数据源并返回响应头、数据年龄和哈希校验结果,验证数据是否实时、过期或未变化。
适用场景
当助手需要基于真实世界的实时传感器读数(如检测到的物体、位置、声音或环境状况)进行推理,或需要确认某路传感器数据是否确实实时时使用。
运行要求
通过 npm 包以 npx 作为本地 Node.js 进程运行,也可用 HTTP 模式在可配置端口上供远程客户端连接。perceive 和 verify 工具需要环境变量 AFFERENS_API_KEY;演示工具无需密钥。注册时提供免费额度。
安装前请注意
API 密钥属于凭据,应避免写入共享配置或日志。服务器会向 Afferens 服务发送查询,传感器数据和请求信息会离开本机。verify 工具会两次抓取数据源,可能消耗额度或令牌。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Afferens,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@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

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

Then set your key:

bash
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:

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

Then register the endpoint:

json
{  "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:

json
{  "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

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

Call afferens_demo - no API key needed.

Usage

Once connected, your AI agent can call:

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

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

For demo verification:

text
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.

Links

License

MIT

来源:README.md,提交 d0f9687

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.2.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。