
Afferens
io.github.afferens由 GitHub 账号 afferens 发布v0.2.1更新于 Oct 24, 2026
Real-time physical perception for AI agents — vision, spatial, acoustic, environmental
概览
Afferens 是一个本地 MCP 服务器,为 AI 助手提供实时物理感知数据:视觉、空间、声音、环境、分子与节点健康。
- 可以做什么
- 按模态(视觉、空间、声音、环境、分子、内感受)查询实时感知事件,支持过滤和数量限制,需 API 密钥。无需密钥即可获取覆盖全部六种模态的演示数据。通过两次抓取数据源并返回响应头、数据年龄和哈希校验结果,验证数据是否实时、过期或未变化。
- 适用场景
- 当助手需要基于真实世界的实时传感器读数(如检测到的物体、位置、声音或环境状况)进行推理,或需要确认某路传感器数据是否确实实时时使用。
- 运行要求
- 通过 npm 包以 npx 作为本地 Node.js 进程运行,也可用 HTTP 模式在可配置端口上供远程客户端连接。perceive 和 verify 工具需要环境变量 AFFERENS_API_KEY;演示工具无需密钥。注册时提供免费额度。
安装
在 SourceWeft 中
- 打开 控制台中的 Afferens,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
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
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
Then set your key:
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:
Then register the endpoint:
Claude Desktop / Cursor / Windsurf
Add to your MCP config file:
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.jsonin your project root - Windsurf:
~/.codeium/windsurf/mcp_config.json
Try it without a key
Call afferens_demo - no API key needed.
Usage
Once connected, your AI agent can call:
Returns structured perception events your agent can reason over and act on.
For demo verification:
Returns two raw snapshots plus headers, age, and a hash check so you can show whether the feed is live, stale, or unchanged.
Links
- afferens.com - sign up, dashboard, API docs
- npm
- Smithery
License
MIT
来源:README.md,提交 d0f9687
工具
0版本历史
1- v0.2.1最新Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。