Cyberlink MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于与基于 Cosmos 的区块链上的 CW-Social 智能合约进行交互。该服务器提供了一个标准化接口，用于创建、更新和查询网络链接（区块链上实体之间的语义关系）。

特征

• 核心运营

  • 创建、读取、更新和删除网络链接

  • 支持使用自定义标识符命名的网络链接

  • 批量操作，高效处理

  • 具有过滤和分页功能的丰富查询功能

• 交易管理

  • 实时交易监控和状态轮询

  • 详细的交易结果和错误处理

  • 支持内部和外部交易签名

  • 代币转移功能

• 高级功能

  • 通过 Hugging Face Transformer 生成语义嵌入

  • 模型运行的实时进度跟踪

  • 语义匹配的余弦相似度计算

  • 灵活的 ID 系统，具有格式化 ID（fids）和全局 ID（gids）

  • 支持 UTC 的基于时间范围的查询

  • 基于所有者的过滤和统计

先决条件

• Node.js 16 或更高版本

• npm 或 yarn 包管理器

• 访问正在运行的 Cosmos 区块链节点

• 钱包中有足够资金进行交易

• 用于开发的Cursor IDE

• Claude Desktop提供人工智能辅助

安装

1. 克隆存储库：

2. 安装依赖项：

3. 构建项目：

4. 配置环境变量（参见配置部分）

配置

MCP 服务器设置

在~/.cursor/mcp.json创建或修改配置文件：

所需配置

所需的环境变量：

• PATH_TO_YOUR_PROJECT ：项目目录的绝对路径

• NODE_URL ：Cosmos 区块链节点 URL

• CONTRACT_ADDRESS ：部署的智能合约地址

可选配置

可选的环境变量：

• WALLET_MNEMONIC ：用于签名的钱包助记符（默认值：无 - 交易将未签名）

• DENOM ：代币面额（默认值：“stake”）

• BENCH32_PREFIX ：BECH32 前缀

可用工具

讯连管理

创作工具

创建_讯连科技

• 描述：创建单个网络链接

• 必填： type

• 可选： from 、 to 、 value

创建_cyberlink2

• 描述：创建节点+链接

• 必需： node_type 、 link_type

• 可选： node_value 、 link_value 、 link_to_existing_id 、 link_from_existing_id

创建命名的 Cyberlink

• 描述：创建名为 cyberlink 的（仅限管理员）

• 必填项： name 、 cyberlink

创建网络链接

• 描述：批量创建网络链接

• 必需： cyberlinks[]

修改工具

update_cyberlink

• 描述：更新现有的讯连科技

• 必需： gid 、 cyberlink

删除讯连科技

• 描述：删除讯连科技

• 必需： gid

更新嵌入

• 描述：添加语义嵌入

• 必需： formatted_id

查询操作

基本查询

查询_by_gid

• 描述：通过全局ID获取

• 必需： gid

query_by_fid

• 描述：通过格式化的ID获取

• 必需： fid

查询网络链接

• 描述：分页列出所有内容

• 参数： limit 、 start_after

query_named_cyberlinks

• 描述：列出已命名的cyberlinks

• 参数： limit 、 start_after

query_by_gids

• 描述：通过 ID 获取多个

• 必需： gids[]

过滤查询

query_cyberlinks_by_type

• 描述：按类型过滤

• 必填： type

query_cyberlinks_by_from

• 描述：按来源过滤

• 必填： from

query_cyberlinks_by_to

• 描述：按目标过滤

• to ：

query_cyberlinks_by_owner_and_type

• 描述：按所有者和类型过滤

• 必需： owner 、 type

基于时间的查询

query_cyberlinks_by_owner_time

• 描述：按创建时间过滤

• 必需： owner 、 start_time

query_cyberlinks_by_owner_time_any

• 描述：按任意时间过滤

• 必需： owner 、 start_time

系统操作

合同信息

查询最后一个 ID

• 描述：获取最后分配的ID

查询配置

• 描述：获取合约配置

查询调试状态

• 描述：获取调试状态（仅限管理员）

获取图表统计信息

• 描述：获取图表统计数据

交易与钱包

查询交易

• 描述：获取 tx 状态

• 必需： transaction_hash

获取交易状态

• 描述：获取详细的交易状态

• 必需： transaction_hash

查询钱包余额

• 描述：获取钱包余额

发送令牌

• 描述：转移代币

• 必填项： recipient ， amount

查询参数

时间范围格式

• 所有时间戳必须采用 ISO 8601 格式

• 例如： 2024-06-01T12:00:00Z

• 如果未指定，则假定为 UTC 时区

• start_time为必填项， end_time为可选项

分页

• start_after ：分页游标

• limit ：每页结果数（默认值：50）

发展

构建命令

项目结构

错误代码

无效参数

• 描述：无效的参数

• 常见原因：缺少必填字段、格式错误

未找到方法

• 描述：未知工具

• 常见原因：工具名称拼写错误、工具已弃用

内部错误

• 描述：系统错误

• 常见原因：网络问题、合同错误

在 SSE 上运行 MCP

您可以使用 Docker 运行 MCP 服务器，将其转换为 SSE 服务器。这可确保 Hugging Face 模型缓存在运行期间持久保存，并从 .env 文件加载环境变量。

• -v $(pwd)/hf-cache:/app/hf-cache安装一个用于模型缓存的本地目录，因此每次都不需要重新下载模型。

• --env-file .env从您的.env文件加载环境变量。

• -p 8000:8000在端口 8000 上公开服务器。

• --name cw-social为您的容器命名，以便于管理。

贡献

1. 分叉存储库

2. 创建功能分支（ git checkout -b feature/amazing-feature ）

3. 提交您的更改（ git commit -m 'Add amazing feature' ）

4. 推送到分支（ git push origin feature/amazing-feature ）

5. 打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。