Lens Protocol MCP Server

镜头协议MCP服务器

一种模型上下文协议（MCP）服务器，提供对镜头协议数据和功能的代理优化访问。

🛠️ 可用工具

镜头搜索

当您需要在Lens Protocol上查找或发现任何内容时

• 找到：帐户、帖子、用户名、应用程序和组
• 自然语言：“加密账户”、“DeFi帖子”、“热门应用”
• 示例: lens_search(query="vitalik", type="accounts", show="concise")

透镜文件

当您想了解有关Lens Protocol帐户的所有信息时

• 综合分析：身份、社会关系、影响力和职位活动
• 包括选项: basic, social, influence, activity （包括帖子）， network
• 示例: lens_profile(who="0x...", include=["basic", "activity"], analyze="influence")

镜头内容

当你想了解内容的表现以及人们对它的看法时

• 内容分析：帖子、反应、评论、参与度指标
• 自然查询：“对此帖子的反应”，“用户热门帖子”
• 示例: lens_content(about="reactions", target="post_123", include=["likes", "comments"])

透镜_生态系统

当您想探索更广泛的镜头协议生态系统时

• 生态系统视图：热门内容、热门应用、平台统计
• 社区见解：应用程序、群组、生态系统健康、增长领域
• 示例: lens_ecosystem(view="trending", timeframe="7d", show="detailed")

资源（数据访问）

• lens://account/{地址} -帐户/个人资料信息
• lens://post/｛id｝ -发布/出版数据
• lens://app/{地址} -申请信息
• lens://group/{地址} -集团信息

📋 响应格式

简明（默认）

为人工智能理解而优化的自然语言摘要：

🔍 Found 5 accounts matching "blockchain":
• vitalik.lens (0x1234...)
• ethereum.lens (0x5678...)
• defi.lens (0x9abc...)
... and 2 more

详细的

完整上下文的摘要+完整JSON数据：

🔍 Found 5 accounts matching "blockchain":
• vitalik.lens (0x1234...)
...

{
  "items": [...],
  "pageInfo": {...}
}

原始

用于编程的直接JSON输出：

{
  "items": [...],
  "pageInfo": {...}
}

🎯 使用示例

搜索帐户

{
  "name": "lens_search",
  "arguments": {
    "query": "vitalik",
    "type": "accounts",
    "show": "concise",
    "limit": 10
  }
}

使用活动和社交数据分析个人资料

{
  "name": "lens_profile",
  "arguments": {
    "who": "0x...",
    "include": ["basic", "activity", "social"],
    "show": "detailed"
  }
}

了解内容参与度

{
  "name": "lens_content",
  "arguments": {
    "what": "reactions to this post",
    "about": "reactions", 
    "target": "post_123",
    "include": ["likes", "comments"]
  }
}

探索生态系统趋势

{
  "name": "lens_ecosystem",
  "arguments": {
    "view": "trending",
    "timeframe": "7d",
    "show": "detailed"
  }
}

安装

bun install

用法

启动服务器

本地（stdio）模式

bun start

远程HTTP模式

bun start:http
# Or with custom port
PORT=8080 bun start:http

服务器支持stdio（用于本地）和HTTP（用于远程访问）传输。

配置

设置环境变量：

• LENS_ENVIRONMENT：为测试网设置为“测试网”，默认为主网
• PORT：HTTP服务器端口（默认值：3000）

MCP客户端配置

本地服务器配置

将此服务器添加到MCP客户端配置中：

{
  "mcpServers": {
    "lens-protocol": {
      "command": "bun",
      "args": ["index.ts"],
      "cwd": "/path/to/lens-mcp"
    }
  }
}

远程服务器配置

对于远程HTTP访问：

{
  "mcpServers": {
    "lens-protocol-remote": {
      "transport": {
        "type": "http",
        "url": "https://lens-mcp.wooo.guru/mcp"
      }
    }
  }
}

发展

以开发模式运行

# Stdio mode
bun dev

# HTTP mode  
bun dev:http

测试

# Run unit tests
bun test

# Run integration tests  
bun test:integration

# Run all tests
bun test:all

Docker部署

# Build and run with Docker
docker build -f docker/Dockerfile -t lens-mcp .
docker run -p 3000:3000 lens-mcp

# Or use docker-compose
docker-compose -f docker/docker-compose.yml up

🏗️ 建筑与设计原则

构建于

• @镜头协议/client@canary -TypeScript官方镜头协议SDK
• @模型上下文协议/sdk -MCP服务器实现
• 包子 -快速JavaScript运行时和包管理器

设计原则

1. 以工作流为中心：工具匹配自然任务细分
2. 上下文高效：内置令牌限制和智能分页
3. 自然语言：默认情况下返回语义摘要
4. 可操作错误：错误消息包括具体指导
5. 多种格式：从中选择 concise, detailed，或 raw 输出

局限性

• 公共客户端模式下的搜索功能有限（需要经过身份验证的会话）
• 一些高级功能需要身份验证，但此服务器中没有实现身份验证
• 速率限制取决于镜头协议API限制

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 测试用 bun test.ts
5. 提交拉取请求

许可证

MIT许可证