AI导哈

模型上下文协议服务

MetaAPP MCP Server 是一个全面的模型上下文协议服务，为MetaApp开发提供项目初始化、协议探索和区块链交互工具。

  • by metaid-developers
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 metaid-developers/metaapp-mcp-server

使用说明

MetaAPP MCP服务器

用于MetaAPP开发的全面MCP（模型上下文协议）服务，为项目初始化、协议探索和区块链交互提供工具。

特性

  • 项目管理：从模板初始化、预览和构建MetaApp项目
  • 环境检测：检查并指导Node.js和Git的安装
  • 协议工具：在区块链上查询和搜索MetaID协议
  • 文档访问：内置MetaID和Metalet钱包API文档
  • PIN管理：从区块链获取和分析PIN数据
  • 用户信息：按地址或MetaID查询用户配置文件
  • 提示模板：常见MetaApp开发任务的预配置提示

安装

先决条件

  • Node.js v20.19.1或更高版本（建议通过NVM）
  • npm或纱线
  • Git

再进行

npm install

发展

以开发模式运行

npm run dev

构建项目

npm run build

运行构建版本

npm start

过程管理（PM2）

服务器包括用于生产部署的PM2配置，具有自动重启功能。

从PM2开始

npm run pm2:start

停止PM2进程

npm run pm2:stop

重新启动PM2进程

npm run pm2:restart

查看日志

npm run pm2:logs

Docker部署

构建Docker镜像

npm run docker:build
# or
docker build -t metaapp-mcp-server .

运行Docker容器

npm run docker:run
# or
docker run -p 3000:3000 metaapp-mcp-server

MCP工具

系统工具

  • 获取助理元数据：获取完整的服务器元数据，包括版本和功能

文档工具

  • 获取资源树：MetaID和Metalet钱包API文档
  • get_manv1_api_resource：MAN V1 API能力和终点
  • get_manv2_api_resource：MAN V2 API功能和端点

环境工具

  • check_environment：检查是否安装了Node.js和Git
  • 安装节点指南：通过NVM安装Node.js的指南
  • 安装指南：Git安装指南

项目工具

  • init工程：从模板初始化新的MetaApp项目
    • 参数： project_name, project_description, target_directory
  • run_工程：运行npm Run-dev预览项目
    • 参数： project_path
  • 建筑工程：构建并打包项目以供部署
    • 参数： project_path

协议工具

  • get_metaprotocol_list：获取元协议列表
    • 参数： cursor （可选）， size （可选）
  • 搜索协议：按名称搜索特定协议
    • 参数： protocol_name
  • 获取详细信息：获取特定PIN的详细信息
    • 参数： pin_id
  • get_pin_list_by_path：按协议路径获取PIN列表
    • 参数： path, cursor （可选）， size （可选）
  • get_user_info：获取用户信息
    • 参数： address_or_metaid

MCP提示

可用提示

  1. meta_app_开发者指南：激活专业MetaApp开发者模式
  2. 编辑：初始化新的MetaApp项目
    • 论据： project_name, project_description
  3. explore_协议：探索和理解MetaID协议
    • 论据： protocol_name
  4. 部署元数据：将MetaApp部署到区块链

用法示例

使用克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "metaapp": {
      "command": "node",
      "args": ["/path/to/MetaAPP-Mcp/dist/index.js"]
    }
  }
}

直接使用

服务器在stdio传输上运行，并通过标准输入/输出进行通信：

node dist/index.js

项目结构

MetaAPP-Mcp/
├── src/
│   ├── config/           # Configuration files
│   ├── prompts/          # Prompt templates
│   ├── tools/            # Tool implementations
│   │   ├── system-tools.ts
│   │   ├── documentation-tools.ts
│   │   ├── project-tools.ts
│   │   └── protocol-tools.ts
│   ├── types/            # TypeScript type definitions
│   ├── utils/            # Utility functions
│   │   ├── helpers.ts
│   │   └── api-client.ts
│   └── index.ts          # Main server entry
├── dist/                 # Compiled JavaScript
├── logs/                 # PM2 logs
├── Dockerfile            # Docker configuration
├── ecosystem.config.cjs  # PM2 configuration
├── tsconfig.json         # TypeScript configuration
└── package.json          # Project metadata

API终点

MetaID API

  • 男子V1: https://man.metaid.io/api
  • 男人V2: https://manapi.metaid.io

关键资源

  • MetaID文档: https://docs.metaid.io/
  • MetaID SDK: https://github.com/metaid-developers/metaid-sdk
  • MetaApp模板: https://github.com/metaid-developers/MetaApp-CLI
  • Metalet钱包: https://metalet.space/
  • 部署: https://metaweb-world.vercel.app

开发工作流程

创建新的MetaApp

  1. 检查环境:

    Use: check_environment

  2. 初始化项目:

    Use: init_project
Parameters: { target_directory: "/path/to/projects" }

  3. 探索协议:

    Use: search_protocol
Parameters: { protocol_name: "simplenote" }

  4. 开发功能：遵循协议结构来实现您的应用程序

  5. 为部署而构建:

    Use: build_project
Parameters: { project_path: "/path/to/project" }

  6. 部署：将生成的zip文件上传到https://metaweb-world.vercel.app

故障排除

找不到Node.js

使用 install_node_guide 该工具用于获取平台的安装说明。

找不到Git

使用 install_git_guide 该工具用于获取平台的安装说明。

构建错误

确保您位于正确的项目目录中，并且已安装所有依赖项：

cd your-project
npm install
npm run build

贡献

欢迎投稿！请遵循以下指南：

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

支持

  • GitHub问题： 创建问题
  • MetaID社区：https://metaid.io/
  • 文档：https://docs.metaid.io/

鸣谢

内置：

MetaAPP MCP服务器 -在人工智能的帮助下支持MetaApp开发

相关 MCP