Agent Adaptor MCP Server安装配置 GitHub与使用方法

选型结论

Agent Adaptor 属于金融服务类 MCP Server，公开资料标注 0 个工具，通过stdio 本地进程接入，客户端适配情况以官方文档为准，有可以直接复制的安装命令；接入前先确认权限范围。

分类

金融服务

传输方式

stdio

认证方式

无需认证

部署方式

公开资料未说明

安装与配置

安装命令

uv run agent-adapter --config simulation/dashboard-preview.yaml start --api-only

公开命令不是通用的启动方式，拼不出可靠配置示例；请在客户端 MCP 配置里按官方文档填写 command 和 args。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Python，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 0 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

详细介绍

代理适配器运行时

此存储库已移动到 AGICitizens/代理适配器. 请使用新的仓库获取最新的代码、问题和贡献。

将任何API或MCP服务器变成自托管的经济代理。

Agent Adapter允许提供商包装现有功能、附加定价、连接钱包、加入代理平台、执行工作并获得报酬，而无需围绕任何一个市场、支付轨道或区块链堆栈重建他们的产品。

该项目目前正在进行中 早期阿尔法核心运行时正常工作，主要架构已经到位，并且有意义的测试覆盖率，但系统仍在发展，一些集成仅在本地或针对沙盒/演示环境进行验证。

该仓库专为开放钱包基金会黑客马拉松而建，侧重于实用的提供商运行时：

发现OpenAPI和MCP的功能
将它们作为运行时工具暴露给代理
定价并在当地启用
通过钱包支持的运行时执行付费工作
支持多种支付方式
为提供者提供一个本地控制平面，用于提示、钱包、指标、操作和能力管理

核心原则

提供者主权：自我托管、自我保管和提供者控制
发现是自动的，货币化是手动的
嵌入式代理在运行时做出决定；提供者通过提示和配置来制定策略
一个适配器实例是一个经济身份
核心与平台无关；平台驱动程序是可选插件，而不是默认路径
尽可能使用无聊、实用的基础设施

为什么存在

大多数代理市场假设提供商将：

围绕平台重写他们的服务
集成特定于平台的任务流
学习链上支付和钱包管道
放弃对定价、身份或基础设施的控制

Agent Adapter采取了相反的方法。

供应商保留：

其API或MCP服务器
他们的钱包
他们的东道主
他们的定价政策
他们的平台选择

运行时处理胶水：

能力发现
工具暴露于试剂
钱包支持的执行
支付适配器
工作追踪
管理API和仪表盘

运行时的设计是为了让提供者保持监护和控制：

密钥由提供商保留
定价保持在运行时本地
能力激活是明确的
infra仍然是自托管的
平台是可选的集成，而不是硬依赖

今天什么有效

能力来源

OpenAPI能力发现
MCP工具发现和执行
针对策划或更高级别能力的手动能力定义
动态的 cap__* 代理循环内的工具生成
使用本地定价覆盖进行规格漂移检测

新发现的功能不会自动上线。发现是自动的，但定价和启用是本地提供商的决定。

代理运行时

支持提示文件的可配置代理循环
提示追加/替换模式
快速热重新加载
创造就业机会和生命周期跟踪
决策日志和管理API

运行时遵循“代理决定”模型：提供商可以通过提示/配置影响优先级、平台偏好、风险承受能力和出价姿态，但嵌入式代理做出实时操作决策。

钱包和支付

钱包插件架构
用于仪表板/演示流的本地预览钱包
原始Solana钱包插件
OWS钱包插件
free 支付适配器
x402 支付流程
带有平台提供的程序有效载荷的通用托管轨道
条纹背衬MPP适配器
当SPT已经可用时，买方MPP质询重试流程

多个支付适配器可以在一个运行时中共存。运行时解决了每个支付挑战的适当适配器，而不是将提供者绑定到单个轨道。

平台与运营

平台驱动程序界面
通过入口点发现驾驶员
安装/删除CLI驱动程序
webhook、SSE和心跳工具
通过扩展插件的出站通知桥

平台驱动程序是有意可选的。默认运行时路径是通用工具加平台文档；对于过于复杂或脆弱而无法可靠处理的流，存在驱动因素。

管理界面

CLI用于初始化、启动、状态、提示、功能、指标、驱动程序、平台和钱包操作
管理API
本地仪表板，包括概述、功能、代理、指标、操作、提示和钱包页面

测试

发现、执行、支付、驱动程序和运行时行为的单元测试
CLI/API/仪表板流的管理表面测试
Surfpool支持的付费执行路径集成覆盖

建筑

在高层次上：

提供者将运行时指向OpenAPI规范或MCP服务器。
运行时发现功能并存储本地货币化设置。
代理将这些功能视为真正的工具。
工具执行通过钱包、支付、作业和扩展层进行。
提供程序通过CLI、API或仪表板管理所有内容。

一个适配器实例等于一个经济身份：一个钱包、一个功能界面、一个提示/定制层和一个代理大脑。想要多个角色或策略边界的提供者可以运行多个实例。

核心构建块：

agent-adapter-contracts

钱包、支付、扩展、驱动程序和运行时事件的通用合约。

agent-adapter

运行时、CLI、管理API、仪表板、存储和编排逻辑。

packages/plugins/*

捆绑钱包、支付和扩展插件。

插件模型有四种主要形状：

可更换核心模块

钱包和其他所需的运行时槽可以用替代实现来替换。

支付适配器

每个支付挑战可以动态注册和解决多个支付适配器。

附加扩展

可选插件订阅运行时生命周期事件，并添加通知或自动化等行为。

代理工具插件

可选插件将代理可调用工具添加到嵌入式运行时。驱动因素是平台编排；工具插件是用于代理工具的。

回购布局

packages/
  agent-adapter/             Runtime, CLI, dashboard, API
  agent-adapter-contracts/   Shared plugin contracts
  plugins/                   Wallet, payment, and extension plugins
docs/
  agent-adapter-runtime-prd.md
  implementation-notes.md
  milestones.md
simulation/
  dashboard-preview.yaml     Easiest local preview config
  provider_api/              Demo provider API
tests/
  test_runtime_unit.py
  test_management_surface.py
  test_runtime_integration.py

包装计划

我们计划将项目分为两个可发布的层：

agent-adapter-contracts

一个轻量级的合约包，包含钱包、支付、扩展、代理工具插件和平台驱动程序的共享接口和运行时事件类型。

agent-adapter

带有CLI、管理API、仪表板、编排、存储和内置插件加载的完整运行时软件包。

这种分裂是有意的。它让更广泛的社区依赖于契约包，而不需要整个运行时，然后在稳定的界面上发布自己的插件。

目标是让其他人更容易构建和发布：

钱包插件
支付适配器
扩展插件
代理工具插件
平台驱动程序
随时间变化的能力源适配器

在实践中，插件作者应该能够导入合约包，实现相关接口，发布包，并让运行时通过配置或入口点发现或加载它。

这是长期OSS计划的关键部分：运行时应该是一个可用的参考实现，而契约包则成为更广泛的插件生态系统的共享基础。

快速入门

需求

python 3.12 或 3.13
uv

安装

uv sync

运行本地仪表板预览

这是查看没有外部依赖的运行时的最快方法。

env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret \
  UV_CACHE_DIR=/tmp/uv-cache \
  uv run agent-adapter --config simulation/dashboard-preview.yaml start --api-only

然后打开：

http://127.0.0.1:9090/dashboard/

有用页面：

http://127.0.0.1:9090/dashboard/
http://127.0.0.1:9090/dashboard/capabilities
http://127.0.0.1:9090/dashboard/metrics
http://127.0.0.1:9090/dashboard/operations
http://127.0.0.1:9090/dashboard/prompt
http://127.0.0.1:9090/dashboard/wallet

常见CLI命令

env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret uv run agent-adapter --config simulation/dashboard-preview.yaml status
env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret uv run agent-adapter --config simulation/dashboard-preview.yaml capabilities list
env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret uv run agent-adapter --config simulation/dashboard-preview.yaml prompt show
env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret uv run agent-adapter --config simulation/dashboard-preview.yaml metrics summary --days 30
env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret uv run agent-adapter --config simulation/dashboard-preview.yaml drivers list
env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret uv run agent-adapter --config simulation/dashboard-preview.yaml tools list
env AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=local-preview-secret uv run agent-adapter --config simulation/dashboard-preview.yaml wallet address

初始化一个新的运行时：

uv run agent-adapter --config ./agent-adapter.yaml init --adapter-name my-agent --data-dir ./runtime-data

在首次启动之前，设置加密环境变量 init 配置中的位置：

export AGENT_ADAPTER_WALLET_ENCRYPTION_KEY=replace-with-wallet-key
export AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY=replace-with-secrets-key
uv run agent-adapter --config ./agent-adapter.yaml start --api-only

示例故事

预期的产品流为：

发现API或MCP工具表面
策划和定价有用的功能
连接钱包
加入平台或响应平台事件
让代理通过运行时工具执行工作
结算付款并在当地跟踪工作
通过指标、操作和通知监控结果

OWS/黑客马拉松相关性

该项目的设计理念是，代理提供商应该有一个真正的钱包支持的运行时，而不是一个围绕第三方基础设施的提示。

OWS在这里很重要，因为它使钱包层成为一级运行时原语：

钱包身份
签署
交易提交
支付结算
提供者控制的保管

更广泛的目标是让代理商务为普通服务提供商服务，而不仅仅是愿意从头开始进行钱包、链、支付和平台集成的团队。

测试

运行主要的本地测试套件：

env UV_CACHE_DIR=/tmp/uv-cache uv run python -m unittest tests.test_runtime_unit tests.test_management_surface -v
python3 -m compileall packages/agent-adapter packages/agent-adapter-contracts packages/plugins tests

Surfpool支持的集成覆盖范围也可用：

env UV_CACHE_DIR=/tmp/uv-cache uv run python -m unittest tests.test_runtime_integration -v

当前注释

仪表板预览使用本地预览钱包插件，而不是真正的链钱包。
从仪表板导入钱包会更新持久配置，需要重新启动才能交换内存中的钱包。
提供程序密钥使用外部适配器密钥加密(AGENT_ADAPTER_SECRETS_ENCRYPTION_KEY)，不是来自活动钱包。
买方MPP流假设运行时已经具有有效的共享支付令牌。
Stripe支持的MPP实施遵循了记录的流程和本地测试，但尚未完全针对此回购中的实时生产Stripe机器支付设置进行验证。

文档

状态

PRD的核心运行时愿景已经实现：

能力发现
动态刀具曝光
钱包支持的执行
多种支付方式
平台驱动程序
管理API和仪表盘
度量和操作工具

剩下的就是打包、入职和实时验证工作，以缩小“工作代码库”和“可安装产品”之间的差距

路线图

包装和分销

\[\]发布 agent-adapter 和 agent-adapter-contracts 所以PyPI pip install agent-adapter 作品
\[\]剪切标记 v0.1.0 在GitHub上发布，并附上发布说明
\[\]设置GitHub操作：对每次推送、lint、编译检查运行测试
\[\]在标签旁边发布发布工件

入职培训和开发人员经验

\[\]制造 agent-adapter init 无需手动设置env-var即可生成工作配置
\[\]提供合理的默认值，以便 agent-adapter init && agent-adapter start 开箱即用
\[\]将快速入门减少到实际的5个命令——与营销网站的承诺相匹配
\[\]添加有指导的首次运行体验，引导提供商完成钱包设置、功能发现和定价

运行时质量

\[\]分解 runtime.py --将引导、功能同步、数据库、钱包设置和管理界面提取到集中的模块中
\[\]删除硬编码模型默认值(openai/gpt-oss-120b)--需要显式的模型配置或提供一个合理的默认值，该默认值不表示对单个提供者的依赖
\[\]添加常见安装失败的结构化错误消息（缺少密钥、配置错误、无法访问规范）

实时验证

\[\]针对真正的外部API的端到端演示，无需Surfpool或本地模拟
\[\]根据实时Stripe机器支付设置验证Stripe支持的MPP流
\[\]针对主网或devnet Solana（不仅仅是本地验证器）测试OWS钱包插件

采用

\[\]编写一个“包装你的第一个API”教程，从一个真正的提供商的OpenAPI规范开始
\[\]为常见提供程序形状（REST API、MCP服务器、手动功能）创建示例配置
\[\]与OWS和代理经济社区接触，以获得反馈和早期采用者

工具与能力

工具数量

0

资源数量

0

提示词数量

0

能力标签

代理经济Python本地部署自托管服务API适配器区块链支付多平台集成

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

行情与财报查询

拉取价格、财报和指标，让模型做对比解读。

持仓与流水

在授权范围内查询持仓、生成流水说明。

风险提示

结合数据给出波动和敞口提醒。

选择建议

值得选的地方

只提供 0 个工具，职责集中，接入后不容易误操作。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

stdio 方式要求本地装好 Python，换机器要重新装一遍。
公开摘要偏短，具体能力和限制要回到仓库确认。
第三方目录整理，版本更新和行为细节以官方仓库为准。

更适合

需要在金融服务场景里让模型直接调用外部能力的人。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Agent Adaptor MCP World · 本页	0	stdio	有	1 个	2026-05-17
MCP Server 273df76d MCP World	0	stdio	有	1 个	2026-05-17
MCP 4a351ada MCP World	0	stdio	有	1 个	2026-05-17
a share MCP is just I need MCP World	0	未说明	未标注	1 个	2026-05-17
Financemcp 538284b7 MCP World	18	stdio	有	1 个	2026-05-17

常见问题

5 条

Agent Adaptor 怎么安装？

公开资料给出的安装命令是 uv run agent-adapter --config simulation/dashboard-preview.yaml start --api-only，运行环境为 Python。装完后按客户端要求写进 MCP 配置，重启客户端生效。

Agent Adaptor 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Python；保存后完全退出客户端再打开，配置才会生效。

Agent Adaptor 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

Agent Adaptor 需要 API Key 吗？

公开资料标注为无需认证，装好就能连；如果实际调用时报鉴权错误，按官方文档补上凭据。

Agent Adaptor 支持哪些客户端？

公开资料没有标注具体客户端；能配置本地 MCP 命令的客户端都能接，配置方式参照官方文档。

来源信息

MCP World

agent-adaptor

将任何API或MCP服务器转换为自托管的经济代理，支持自动发现、定价、钱包连接和多支付通道。

www.mcpworld.com

/detail/d5ee499fd10200fa85b1c70ca797ff7e

参考链接

仓库入口

github.com

/NiravJoshi33/agent-adaptor

来源标签