Cyberlink MCP 服务器

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

特性

• 完整的 cyberlink CRUD 操作
• 命名 cyberlink 支持
• 批量操作
• 丰富的查询功能
• 交易状态跟踪
• 输入验证
• 错误处理
• 与 Cursor IDE 和 Claude Desktop 集成

前提条件

• Node.js 16+
• npm 或 yarn
• 访问 Cosmos 区块链节点
• 具有交易资金的钱包
• 安装 Cursor IDE
• 安装 Claude Desktop

安装和设置

1. 克隆存储库：

git clone https://github.com/your-org/cw-social-mcp.git
cd cw-social-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

集成配置

Cursor IDE 和 Claude Desktop 都使用相同的 MCP 配置格式。创建或编辑配置文件：

• 对于 Cursor：~/.cursor/mcp.json

添加以下配置：

{
    "mcpServers": {
        "cw-graph": {
        "command": "node",
        "args": ["PATH_TO_YOUR_PROJECT/dist/index.js"],
        "env": {
            "NODE_URL": "http://localhost:26657",
            "WALLET_MNEMONIC": "your wallet mnemonic phrase",
            "CONTRACT_ADDRESS": "your contract address",
            "DENOM": "stake"
            }
        }
    }
}

替换以下值：

• PATH_TO_YOUR_PROJECT: cw-social-mcp 项目的绝对路径
• NODE_URL: 您的 Cosmos 节点 URL
• WALLET_MNEMONIC: 您钱包的助记词
• CONTRACT_ADDRESS: 您部署的合约地址
• DENOM: (可选) 代币面额，默认为 'stake'

该配置使用 stdio 格式进行 MCP 服务器和客户端（Cursor/Claude Desktop）之间的通信。

验证

1. 配置后重启 Cursor IDE 或 Claude Desktop
2. 以下工具应该可用：
   • create_cyberlink
   • create_named_cyberlink
   • create_cyberlinks
   • update_cyberlink
   • delete_cyberlink
   • query_cyberlinks
   • query_named_cyberlinks
   • query_cyberlinks_by_owner
   • query_config
   • query_wallet_balance
   • send_tokens

开发

1. 构建项目：

npm run build

2. 在开发模式下启动服务器：

npm run dev

项目结构

src/
├── index.ts             # 主要入口点
├── cyberlink-service.ts # Cyberlink 和区块链操作
└── types.ts             # TypeScript 类型和模式

cursor_rules/
└── chat_history.mdc    # 聊天记录存储规则

Cursor 规则

该项目包含定义特定功能行为的 cursor 规则：

• 聊天记录存储: 定义聊天记录如何在系统中存储和管理的规则。这些规则确保跨 MCP 服务器对会话数据进行一致的处理。

将规则复制到 ./cursor/rules 目录中

MCP 工具

创建和修改

• mcp_cw_graph_create_cyberlink - 创建一个新的 cyberlink
• mcp_cw_graph_create_named_cyberlink - 创建一个带有标识符的命名 cyberlink
• mcp_cw_graph_create_cyberlinks - 批量创建多个 cyberlink
• mcp_cw_graph_update_cyberlink - 通过 ID 更新现有的 cyberlink
• mcp_cw_graph_delete_cyberlink - 通过 ID 删除 cyberlink

基本查询

• mcp_cw_graph_query_by_id - 通过数字 ID 查询单个 cyberlink
• mcp_cw_graph_query_by_formatted_id - 通过其格式化的 ID 查询 cyberlink
• mcp_cw_graph_query_cyberlinks - 查询所有带有分页的 cyberlink
• mcp_cw_graph_query_named_cyberlinks - 查询所有命名的 cyberlink
• mcp_cw_graph_query_by_ids - 通过其 ID 查询多个 cyberlink

高级查询

• mcp_cw_graph_query_by_owner - 按所有者地址查询 cyberlink
• mcp_cw_graph_query_by_time_range - 按创建时间范围查询 cyberlink
• mcp_cw_graph_query_by_time_range_any - 按创建或更新时间范围查询 cyberlink

系统查询

• mcp_cw_graph_query_last_id - 获取最后分配的 cyberlink ID
• mcp_cw_graph_query_config - 查询合约配置
• mcp_cw_graph_query_debug_state - 查询合约调试状态（仅限管理员）
• mcp_cw_graph_get_tx_status - 检查交易状态并获取 cyberlink ID

钱包操作

• mcp_cw_graph_query_wallet_balance - 获取钱包地址和代币余额
• mcp_cw_graph_send_tokens - 将代币发送到另一个钱包地址

查询参数

时间范围查询

• owner - 要过滤的所有者地址
• start_time - 以纳秒为单位的开始时间 (Uint64，可以作为字符串或数字传递)
• end_time - 可选的以纳秒为单位的结束时间 (Uint64，可以作为字符串或数字传递)
• start_after - 可选的分页游标 (Uint64，可以作为字符串或数字传递)
• limit - 可选的结果限制（默认值：50）

分页

大多数查询端点都支持分页，使用：

• start_after - 下一页的游标 (Uint64，可以作为字符串或数字传递)
• limit - 要返回的最大结果数

数据类型

• 时间戳: 所有时间戳字段都使用 Uint64 格式（自 Unix 纪元以来的纳秒数）
  • 可以作为字符串传递，以保留大值的精度
  • 也接受数字格式以实现向后兼容
  • 示例: "1683900000000000000" (字符串) 或 1683900000000000000 (数字)

错误处理

服务器使用来自 MCP 协议的标准化错误代码：

• InvalidParams - 无效的输入参数
• MethodNotFound - 未知的工具名称
• InternalError - 区块链或服务器错误

贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

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