道德里斯-MCP服务器
项目介绍
🧠 概述
Moralis MCP 服务器 是一个可本地或云端部署的引擎，它将自然语言提示与真实的区块链洞察连接起来——使AI模型能够查询钱包活动、代币指标、dapp使用情况等，而无需自定义代码或SQL。
基于模型上下文协议，此服务器使得LLMs可以以一致、可解释且可扩展的方式与Moralis API进行通信。
- 🔗 完全可插拔：交换LLMs，自定义检索逻辑，或通过自己的工具进行扩展
- 🧱 支持OpenAI、Claude和开源模型
- 🧠 驱动代理、开发工具、机器人、仪表板等
⚙️ 常见用例
- 🤖 AI代理及助手：“这个钱包的交易历史是什么？”
- 📈 开发工具：链上QA、测试、CLI集成
- 📊 仪表板：自然语言到图表/数据
- 📉 监控：代币/dapp的警报及总结
- 🧠 交易机器人：基于真实区块链基础的LLM驱动策略
🔐 获取API密钥
要使用此MCP服务器与Moralis API交互，您需要一个API密钥：
export MORALIS_API_KEY=<your_api_key>
⚠️ 注意：某些功能和端点需要Moralis付费计划。为了获得完全访问权限和生产级性能，我们建议注册付费层级。
🚀 使用客户端
要将MCP服务器连接到兼容客户端（例如Claude Desktop、OpenAI兼容代理、VS Code扩展等），需配置客户端以作为子进程启动服务器。
大多数客户端支持简单的配置文件——例如，您可以在客户端配置目录中创建一个如mcp.json的文件，内容如下：
{
"mcpServers": {
"serverName": {
"command": "npx @moralisweb3/api-mcp-server",
"args": [],
"env": {
"MORALIS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
此设置可以根据任何支持MCP服务器的客户端进行调整。替换示例值为特定于您使用场景的值。
通过Smithery安装
要通过Smithery自动安装Moralis API服务器用于Claude Desktop：
npx -y @smithery/cli install @MoralisWeb_Web3/moralis-mcp-server --client claude
🖥️ 作为服务器使用
服务器接受一个可选的--transport参数来指定传输类型。可用的传输类型包括：
stdio：通过标准输入/输出通信（默认）。web：启动HTTP服务器进行通信。streamable-http：启动具有流式端点的HTTP服务器。
示例
- 使用默认的
stdio传输：
moralis-api-mcp --transport stdio
- 使用
web传输：
moralis-api-mcp --transport web
这将启动一个HTTP服务器。您可以使用curl或Postman等工具向服务器发送请求。
- 使用
streamable-http传输：
moralis-api-mcp --transport streamable-http
这将启动一个HTTP服务器。您可以使用curl或Postman等工具向服务器发送请求。
注意事项
- 确保在启动服务器之前设置了所需的环境变量（例如，
MORALIS_API_KEY）。 - 对于自定义配置，您可以根据需要传递额外的参数或环境变量。
- 查阅文档以获取有关每种传输类型的详细信息。
🛠 开发
安装依赖项：
npm install
构建服务器：
npm run build
开发时自动重建：
npm run watch
🐞 调试
由于MCP服务器通过stdio通信，调试可能会有挑战性。我们推荐使用MCP Inspector，它作为一个包脚本提供：
npm run inspector
Inspector将提供一个URL，以便您在浏览器中访问调试工具。
💬 示例提示
这里是一些您可以通过MCP服务器与AI代理使用的示例提示：
- PEPE和以太坊当前的价格是多少？
- 在Base上的TOSHI当前的交易情绪是看涨还是看跌？
- 显示`vitalik.eth`在Base上拥有的NFT。
- 钱包`0xab71...4321`持有哪些代币？
- 钱包0xabc...123在以太坊、Base和Polygon上首次和最后一次活跃的时间是什么时候？
- 显示0xabc...123在以太坊、Base和BNB Chain上的完整交易历史。
- 钱包0xabc...123当前的美元净资产是多少？
- 找出可能与Coinbase相关的钱包地址。
- 分析SPX6900的当前持有人分布——包括鲸鱼、小持有人以及最近的增长趋势。
- 显示过去30天PEPE的日OHLC数据，并提供趋势总结——它是看涨还是看跌？
这些提示被解析并映射到使用MCP方法注册表的结构化Moralis API调用。
💡 您还可以基于任何支持的方法构建自定义提示。
📚 API参考
Moralis MCP服务器封装并翻译提示为Moralis REST API调用。您可以在这里探索底层API接口：
该文档涵盖了以下端点：
- 代币定价
- 钱包活动
- NFT元数据和所有权
- 转移和交易
- 更多