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

1. explore_协议：探索和理解MetaID协议

- 论据： protocol_name

1. 部署元数据：将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

1. 初始化项目:

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

1. 探索协议:

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

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

1. 为部署而构建:

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

1. 部署：将生成的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/

鸣谢

内置：

• @模型上下文协议/sdk
• TypeScript
• 阿西奥斯
• 简单git
• PM2

______________________________________________________________________

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