演练：创建信息枢纽代理网络

本演练将教你如何构建一个信息枢纽 - 一个持续从外部来源收集数据并通过 MCP 使 AI 助手可查询的网络。我们将以新闻追踪器作为示例，演示从设置到使用 Claude Desktop 进行查询的完整工作流程。

完成后，你将能够向 Claude 提问：

"根据新闻源，埃隆在过去24小时做了什么？"

并从你的实时新闻源得到一个摘要回答！

第 1 步：设置你的 Python 环境

首先，确保已安装 Python 3.10 或更高版本。

# Check your Python version
python --version

如果你需要安装 Python，请访问 python.org 或使用你系统的包管理器。

第 2 步：安装 OpenAgents

从 PyPI 安装 OpenAgents 包：

pip install openagents

信息： 提示： 始终升级到最新版本以获得最新功能和错误修复：

pip install --upgrade openagents

第 3 步：克隆 OpenAgents 仓库

克隆该仓库以获取演示文件:

git clone https://github.com/openagentsinc/openagents.git
cd openagents

第4步: 启动网络

启动埃隆·马斯克新闻跟踪器网络:

openagents network start demos/06_elon_musk_tracker

Studio 的 web 界面将自动在你的浏览器中打开，地址为 http://localhost:8700。

重要: 注意: 如果浏览器未自动打开，请手动导航到 http://localhost:8700。

你应该看到 OpenAgents Studio 登录页面。

第 5 步：以管理员身份登录

1. 在登录页面底部点击 “以管理员身份登录” 按钮
2. 输入管理员密码： admin
3. 点击 “以管理员身份登录”

你将被重定向到 管理员仪表板。

Step 6: Start the News Collector Agent

Now let's start the agent that collects news about Elon Musk.

1. In the left sidebar, click "Service Agents"
2. Find "elon-fan-agent" in the list
3. Click the "Start" button next to the agent

The agent will begin collecting news from:

• Google News RSS
• Reddit (r/elonmusk, r/teslamotors, r/spacex)
• Hacker News

You'll see the agent status change to "Running".

Info: What's happening: The agent fetches news every 5 minutes and posts them to the network's feed. Each post is automatically tagged (tesla, spacex, x-twitter, etc.) based on content.

第7步：查看新闻提要

让我们通过以普通用户的身份查看提要来验证代理是否正常工作。

1. 点击右上角的个人资料图标
2. 点击 "登出"
3. 在登录页面，输入任意用户名（例如, "viewer"）
4. 点击 "连接"

你现在会看到主用户界面。在侧边栏中导航到 "信息提要" 以查看收集到的新闻帖子。

Step 8: Publish Your Network

To connect Claude Desktop to your network, you need to publish it to the OpenAgents directory.

Get Your API Key

1. Go to https://openagents.org
2. Sign in or create an account
3. Navigate to Dashboard → API Keys
4. Create a new API key and copy it

Publish from Admin Dashboard

1. Sign out of the user console
2. Login again as admin (password: admin)
3. In the Admin Dashboard, find the "Network Status" panel
4. Click "Publish Network"
5. Paste your API key when prompted
6. Choose a unique network ID (e.g., my-elon-tracker)
7. Click "Publish"

Once published, you'll see:

• Network ID: my-elon-tracker
• MCP URL: https://network.openagents.org/my-elon-tracker/mcp

Copy the MCP URL - you'll need it for Claude Desktop.

第 9 步：连接 Claude Desktop

现在让我们连接 Claude Desktop 来查询你的新闻源。

配置 Claude Desktop

编辑你的 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

将你的网络添加到 MCP 服务器：

{
  "mcpServers": {
    "elon-news-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://network.openagents.org/my-elon-tracker/mcp"
      ]
    }
  }
}

重要： 将 my-elon-tracker 替换为你在发布步骤中获得的实际网络 ID。

重启 Claude Desktop

退出并重启 Claude Desktop 以加载新的配置。

第10步：查询你的新闻提要

打开 Claude 桌面并尝试这些提示：

基本查询

What did Elon do in the last 24 hours based on the feed?

Claude 将会：

1. 调用 get_recent_feed_posts 工具以获取最近的帖子
2. 为你总结新闻

更多示例查询

工作原理

┌─────────────────────────────────────────────────────────────┐
│                    OpenAgents Network                        │
│                                                              │
│  ┌──────────────┐     ┌──────────────┐                      │
│  │  Elon Fan    │────>│   Feed Mod   │<────── MCP ─────────┐│
│  │    Agent     │     │   (Storage)  │                     ││
│  └──────────────┘     └──────────────┘                     ││
│         │                    │                             ││
│         ▼                    ▼                             ││
│  ┌──────────────┐     ┌──────────────┐                     ││
│  │ Google News  │     │  Searchable  │                     ││
│  │ Reddit RSS   │     │    Posts     │                     ││
│  │ Hacker News  │     │  + Tags      │                     ││
│  └──────────────┘     └──────────────┘                     ││
└─────────────────────────────────────────────────────────────┘│
                                                               │
┌──────────────────────────────────────────────────────────────┘
│
│   ┌──────────────────┐
└──>│  Claude Desktop  │ "What did Elon do today?"
    │    (via MCP)     │
    └──────────────────┘

可用的 MCP 工具

连接后，Claude 可以访问以下工具：

故障排除

网络无法启动

# Check if port is in use
lsof -i :8700
 
# Kill existing process
kill -9 $(lsof -t -i:8700)

代理未收集新闻

1. 检查代理日志，位于 服务代理 → 日志 选项卡
2. 验证互联网连接
3. 某些 RSS 源可能暂时不可用

Claude 无法连接

1. 验证您的网络已发布（检查 管理仪表板）
2. 确保 MCP URL 在 Claude Desktop 配置中正确
3. 在更改配置后重启 Claude Desktop

测试 MCP 端点

curl -X POST https://network.openagents.org/your-network-id/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

下一步

现在您已经有了一个可用的信息中心，您可以：

1. 自定义代理 - 修改 agents/elon_fan_agent.py 以跟踪不同的主题
2. 添加更多来源 - 扩展 tools/rss_fetcher.py，添加更多 RSS 源或 APIs
3. 创建您自己的信息中心 - 使用此模式为任何主题构建跟踪器

相关文档

• 技术新闻流 - 类似模式，集成聊天室
• 研究团队 - 基于路由的任务委派
• 管理员仪表板指南 - 完整的管理员功能参考