Skip to main content
Glama
eneszh
mariiammaysara

rel_mcp

by mariiammaysara
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

LYNK

为通过关系开展工作的人打造的会议与关系智能。

将每一次外部会议自动转化为关系智能。

Python MCP SQLite Telegram Tests

记住关系，而不仅仅是会议。

你的日历告诉你你要见谁。

你的收件箱告诉你之前发生了什么。

你的 CRM 告诉你记录在案的内容。

你的记忆本应把三者串联起来。

LYNK 做的就是这件事。

LYNK 是一个基于 Telegram 的 AI 智能体，会围绕你合作的人和机构构建持久化的上下文。

会议前，它会用相关历史为你做好准备。

会议后，它能记录发生了什么。

会议间隙，它会持续追踪尚未了结的事项。

它专为工作依赖于反复发生的外部关系的人而设计——销售代表、客户经理、顾问、招聘人员、创始人、自由职业者、代理机构、高管，以及任何需要记住说过什么、承诺过什么、下一步要做什么的人。

会议前

了解历史。

↓

会议中

记录发生了什么。

↓

会议后

让关系持续向前推进。

Related MCP server: Graphiti MCP Server

会议前

走进会议室之前，你已经掌握全部背景。

在外部会议开始前 45–75 分钟，LYNK 会直接向 Telegram 发送一份简报。

不是日历摘要。

而是一份基于你与该人士或机构已有历史构建的关系简报。

它可以呈现：

  • 最近一次联系 —— 你们上次沟通的时间以及当时的情况

  • 承诺事项 —— 你欠对方的，以及对方欠你的

  • 已达成的协议 —— 实际确认过的条款

  • 未闭环的事项 —— 仍未解决的问题、任务和后续跟进

  • 建议提问 —— 根据关系历史值得问的问题

目标不是告诉你日历上有什么。

而是提醒你在走进会议室之前，什么才是真正重要的。

真正重要的部分

大多数 AI 系统都非常擅长总结。

LYNK 关注的是更难的一件事：

我们到底知道什么？

一段对话可能包含这样的内容：

说过 → 讨论过 → 建议过 → 达成一致 → 确认过

这些并不是一回事。

LYNK 明确保留了这种区分。

        DISCUSSION
             │
             ▼
        ┌──────────┐
        │ DECISION │
        └────┬─────┘
             │
             ▼
       ┌────────────┐
       │ COMMITMENT │
       └──────┬─────┘
              │
              ▼
       ┌────────────┐
       │ CONFIRMED  │
       └────────────┘

AI 生成的表述不会因为听起来很自信就变成事实。

未经核实的信息在得到确认之前，始终是未经核实的。

会议后

LYNK 可以把会议本身转化为结构化的关系数据。

JOIN → RECORD → TRANSCRIBE → EXTRACT → UPDATE

它可以记录：

  • 关键讨论要点

  • 决策

  • 承诺事项

  • 未解决的问题

  • 后续跟进事项

会议后同样适用这条规则：

讨论并不自动等于决策。

表述并不自动等于承诺。

关系记录会得到更新，但不会悄悄改写历史。

会记住的关系

LYNK 的核心是一个持久化的本地关系账本。

它会在与人和机构的互动中不断积累上下文：

                         RELATIONSHIP
                              │
          ┌───────────────────┼───────────────────┐
          │                   │                   │
       PEOPLE             INTERACTIONS       ORGANIZATIONS
          │                   │                   │
          └───────────────────┼───────────────────┘
                              │
                     ┌────────┴────────┐
                     │                 │
                COMMITMENTS        AGREEMENTS
                     │                 │
                     └────────┬────────┘
                              │
                         OPEN LOOPS

随着时间推移，LYNK 越来越不像一个会议助手，而更像一层你职业关系之上的记忆层。

需要时随时问

你不必等到下一次定时简报。

直接问就行。

"What did we agree on last time?"

"What are they waiting for from us?"

"What commitments are overdue?"

"When did we last talk?"

"What's our status with Acme?"

LYNK 会查询已积累的关系上下文，而不是从零开始。

然后它会持续运转

一旦启用，LYNK 就能安静地处理周期性的关系维护：

每周关系摘要 以紧凑的视图呈现有意义的关系动态。

逾期承诺提醒 把仍在等待某人处理的事项呈现出来。

任务委派 无需离开 Telegram，即可把一段对话变成一项行动。

会后智能 自动记录决策、承诺和后续跟进。

远程终止开关 需要时直接从 Telegram 停止该智能体。

无需维护仪表盘。 无需手动更新关系数据库。

系统负责维护上下文。

你只管使用。

运行 LYNK

LYNK 有两种运行方式：

本地 —— 一切都在你自己的电脑上运行。

服务器 —— 智能体在 Linux VPS 上 24/7 保持在线，即使你的电脑关机也不受影响。

如果你是第一次搭建 LYNK，请从本地开始。本地跑通后，再把同一套配置迁移到服务器上。

你需要准备什么

项目

用途

Python 3.11+

运行 LYNK MCP 服务器

Google 账号

访问日历 + Gmail

Telegram 账号

机器人投递与交互

Hermes Agent

模型、编排、Telegram 与调度

1. 安装 Python

LYNK 需要 Python 3.11+。

检查你的版本：

python --version

或者：

python3 --version

你需要 Python 3.11 或更高版本。

2. 安装 uv

LYNK 使用 uv 来管理 Python 环境和依赖。

macOS / Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

重启终端并验证：

uv --version

在 Windows 上，请按照 uv 的 Windows 安装说明进行安装，并在 PowerShell 中验证同样的命令。

3. 克隆 LYNK

git clone https://github.com/mariiammaysara/LYNK.git
cd LYNK

4. 安装依赖

uv sync --all-groups

然后运行测试：

uv run pytest

LYNK 目前有 220+ 个测试。

5. 创建 Google Cloud 项目

打开 Google Cloud Console：

https://console.cloud.google.com/

创建一个新项目，例如：

lynk-agent

然后进入：

APIs & Services → Library

启用：

  • Google Calendar API

  • Gmail API

6. 配置 Google OAuth

进入：

APIs & Services → OAuth consent screen

对于仅限 Workspace 的应用选择 Internal，对于个人 Gmail 账号选择 External。

添加只读范围：

https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/gmail.readonly

如果应用是 External 且处于测试模式，请在 Test users 下添加你自己的 Google 账号。

然后进入：

APIs & Services → Credentials → Create Credentials → OAuth client ID

选择：

Desktop app

下载凭据并保存为：

credentials.json

放在项目根目录：

LYNK/
├── credentials.json
├── rel_mcp/
├── scripts/
└── ...

该文件已被 Git 忽略。

切勿提交它。

7. 配置环境

创建你的环境文件：

cp .env.example .env

在 Windows PowerShell 上：

Copy-Item .env.example .env

配置：

GOOGLE_CREDENTIALS_PATH=./credentials.json
OWNER_EMAIL=<your Google email>
TIMEZONE=<your timezone>

如果位于埃及：

TIMEZONE=Africa/Cairo

8. 使用 Google 进行身份验证

运行：

uv run python scripts/google_check.py

浏览器应该会打开。

使用你配置的 Google 账号登录，并批准所请求的只读权限。

成功设置后，应该会显示类似这样的信息：

connected as: you@example.com

至此，LYNK 的 Google 部分已经就绪。

9. 创建 Telegram 机器人

打开 Telegram，给 @BotFather 发消息。

发送：

/newbot

选择一个显示名称和一个以 bot 结尾的用户名。

BotFather 会给你一个机器人令牌。

像对待密码一样对待它。

打开新机器人并按下 Start。

10. 配置 Hermes

单独安装 Hermes，然后创建 LYNK 配置文件：

hermes profile create lynk \
  --description "Meeting and relationship agent"

配置模型提供商：

hermes -p lynk auth add openrouter

如果愿意，也可以使用 Hermes 支持的其他提供商。

设置你的时区：

hermes -p lynk config set timezone Africa/Cairo

配置 Telegram：

hermes gateway setup

在提示时提供 Telegram 机器人令牌。

11. 启动网关

hermes gateway run

给你的机器人发送一条消息，例如：

What's my status with Acme?

或者：

When did we last talk?

然后验证即将到来的外部会议是否生成了定时简报。

对于本地定时任务，你的电脑必须保持开机并连接互联网。

本地搭建跑通后，将 LYNK 部署到 Linux VPS 上。

VPS 就是一台远程 Linux 机器，在你自己的电脑关机时它仍然保持在线。

1. 连接服务器

创建一台 Linux VPS 并通过 SSH 连接：

ssh youruser@YOUR_SERVER_IP

2. 准备服务器

sudo apt update
sudo apt upgrade -y
sudo apt install -y git curl

验证 Python：

python3 --version

安装 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

验证：

uv --version

3. 安装 LYNK

git clone https://github.com/mariiammaysara/LYNK.git
cd LYNK

uv sync --all-groups
uv run pytest

在继续之前，确保测试全部通过。

4. 配置环境

cp .env.example .env

设置：

GOOGLE_CREDENTIALS_PATH=./credentials.json
OWNER_EMAIL=<your Google email>
TIMEZONE=<your timezone>

将 credentials.json 安全地复制到服务器。

在本地机器上执行：

scp credentials.json youruser@YOUR_SERVER_IP:/path/to/LYNK/credentials.json

然后在服务器上执行：

chmod 600 credentials.json

5. 完成 Google 身份验证

无头服务器通常没有浏览器。

如果 OAuth 流程需要浏览器，请从本地电脑创建 SSH 隧道：

ssh -L 8080:localhost:8080 youruser@YOUR_SERVER_IP

保持该 SSH 会话开启。

在服务器上执行：

cd LYNK
uv run python scripts/google_check.py

在本地浏览器中完成 Google 登录。

生成的身份验证状态应保留在服务器上。

切勿提交 OAuth 令牌或凭据。

6. 配置 Hermes

在服务器上安装 Hermes 并创建配置文件：

hermes profile create lynk \
  --description "Meeting and relationship agent"

hermes -p lynk auth add openrouter
hermes -p lynk config set timezone Africa/Cairo
hermes gateway setup

输入 Telegram 机器人令牌。

先手动测试：

hermes gateway run

发送一条 Telegram 消息，确保一切正常。

在手动测试成功之前，不要配置 systemd。

7. 让它永久运行

找到 Hermes 可执行文件：

which hermes

创建：

sudo nano /etc/systemd/system/lynk.service

使用：

[Unit]
Description=LYNK Hermes gateway
After=network.target

[Service]
Type=simple
User=youruser
WorkingDirectory=/opt/lynk
ExecStart=/usr/local/bin/hermes gateway run
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

根据你的服务器调整 User、WorkingDirectory 和 ExecStart。

然后：

sudo systemctl daemon-reload
sudo systemctl enable lynk
sudo systemctl start lynk

检查：

sudo systemctl status lynk

使用以下命令跟踪日志：

sudo journalctl -u lynk -f

现在，LYNK 会在服务器重启后自动启动，并且在你断开 SSH 后继续运行。

在认为部署完成之前：

[ ] Python 3.11+ installed
[ ] uv installed
[ ] LYNK dependencies installed
[ ] pytest passes
[ ] Google Calendar API enabled
[ ] Gmail API enabled
[ ] OAuth credentials configured
[ ] Google authentication succeeds
[ ] Telegram bot created
[ ] Telegram bot responds
[ ] Hermes profile configured
[ ] Model provider works
[ ] Hermes gateway works manually
[ ] systemd service starts
[ ] Service survives SSH logout
[ ] Service starts after reboot
[ ] Scheduled brief arrives

让机密信息远离 Git

切勿提交：

.env
credentials.json
OAuth tokens
Telegram bot tokens
API keys
private databases

保护服务器

尽可能使用 SSH 密钥，并避免暴露不必要的端口。

保护 Telegram

像对待密码一样对待 Telegram 机器人令牌。

如果令牌泄露，请通过 BotFather 撤销或重新生成。

保护关系数据

本地数据库可能包含联系人、机构、会议、承诺和对话的信息。

请将服务器及其备份视为敏感数据存储。

Google 权限

LYNK 的 Google 集成使用只读的 Calendar 和 Gmail 范围。

架构

LYNK 将确定性业务逻辑与智能体推理分开。

Calendar + Gmail + CRM
          │
          ▼
     ┌──────────┐
     │ rel_mcp  │
     │ facts +  │
     │  rules   │
     └────┬─────┘
          │
          ▼
     ┌──────────┐
     │  Hermes  │
     │   agent  │
     └────┬─────┘
          │
          ▼
       Telegram

rel_mcp 负责检索、关系状态、分类和确定性业务规则。

Hermes 提供模型、编排、Telegram、调度和审批层。

LLM 不是事实来源。

已构建功能

核心 —— 已构建并测试

附加 —— 已构建并测试

✓ 会前智能

✓ 每周关系摘要

✓ 关系账本

✓ 每日承诺提醒

✓ 承诺跟踪

✓ 任务委派

✓ 逾期检测

✓ 远程终止开关

✓ 即时关系查询

✓ 会后记录与转写

✓ 决策与承诺提取

有关实现细节，以及确定性规则、确认处理、环境约定和测试决策背后的设计考量，请参阅 README.dev.md。

由 Mariam Maysara 构建

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
A
license - permissive license
Not graded
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Graphiti MCP Server

    chen9z
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to build and query temporally-aware knowledge graphs from conversations and data, maintaining persistent memory of entities, relationships, and facts across interactions.

  • MIND MCP Server

    theastraway
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to persist and retrieve memories via a personal knowledge graph, with tools for emotional intelligence, CRM, life management, social features, self-training, and autonomous insights.
    116
    5
    MIT

  • dejaview-mcp

    JakeC77
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides persistent knowledge graph memory for AI agents, enabling them to store, recall, and query facts about people, projects, and relationships across sessions.
    MIT

View all related MCP servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mariiammaysara/LYNK'

If you have feedback or need assistance with the MCP directory API, please join our Discord server