Aaif MCP Server

AAIF PMO代理——MCP服务器

跨12个领域的49个工具，用于自动化Linux Foundation AAIF成员入职流程——层验证、合规性筛选、邮件列表配置、联系人管理、日历安排、工作组注册、选举、新闻稿、品牌验证、续订情报和D1-D5检查表编排。

同一台MCP服务器为多个客户端供电：

沙盒模式：此服务器完全在 模拟数据 默认情况下。演示所有48个工具不需要后端凭据或API访问权限。当环境变量未设置时，每个连接器都会自动回退到模拟。

快速入门（5分钟）

1.克隆并安装

git clone git@github.com:linuxfoundation/aaif-mcp-server.git
cd aaif-mcp-server
pip install -e ".[test]"

2.添加到克劳德桌面

打开 设置>开发人员>编辑配置 在Claude Desktop中，然后将此添加到 mcpServers:

{
  "mcpServers": {
    "aaif-onboarding": {
      "command": "python",
      "args": ["-m", "aaif_mcp_server.server"],
      "cwd": "/path/to/aaif-mcp-server/src"
    }
  }
}

替代 如果你跑了 pip install -e .: ``json { "mcpServers": { "aaif-onboarding": { "command": "aaif-mcp-server" } } } ``

3.重新启动克劳德桌面

重新启动后，您应该看到49个可用工具。服务器运行 模拟数据 默认情况下，测试不需要凭据。

验证它是否正常工作

在Claude Desktop中，尝试：

• “验证Hitachi的会员级别”→ validate_membership_tier
• “列出彭博社的联系人”→ list_contacts
• “让Sam Altman加入代理商务工作组”→ enroll_in_working_group
• “检查代理商务主席的选举状态”→ get_election_status
• “Natoma的流失风险是什么？”→ predict_churn_risk
• “起草OpenAI加入AAIF的新闻稿”→ draft_press_release
• “获取续订仪表板”→ get_renewal_dashboard
• “运行OpenAI Sam Altman的入职检查表”→ run_onboarding_checklist

运行测试

pytest tests/ -v
# 176 tests pass (28 pre-existing failures in tests without registry init)

______________________________________________________________________

工具（12个域中的49个）

域1：邮件列表设置（4个工具）

域2：日历和会议管理（3个工具）

领域3：合规与制裁（4种工具）

域4：层验证（3个工具）

域5：联系人角色管理（5个工具）

域6：工作组注册（5个工具）

领域7：选举和投票操作（5个工具）

领域8：新闻稿起草（3个工具）

领域9：徽标和品牌验证（3个工具）

领域10：入职呼叫调度（3个工具）

领域11：更新和参与智能（5个工具）

领域12：编排（5个工具）

______________________________________________________________________

生产所需的API访问权限

此服务器连接到 7外部系统在沙盒模式下，当环境变量未设置时，所有连接器都会自动回退到模拟数据。

连接器状态

环境变量

# 0. PIS (Project Infrastructure Service) — X-ACL header auth
#    API: V2 — Groups.io, LFX Meeting, GitHub connectors
#    Used by: Mailing List Provisioning, Calendar/Meeting Mgmt, WG Enrollment, Offboarding
PIS_ACL_TOKEN=
PIS_USERNAME=
PIS_PROJECT_ID=lfZA9uadMdkwBqqHsj

# 1. Salesforce CRM — OAuth 2.0 username-password flow
#    API: REST v59.0 — SOQL queries on Account, Contact objects
#    Used by: Tier Validation, Compliance, Contact Roles, Orchestrator
SFDC_INSTANCE_URL=https://aaif--sandbox.my.salesforce.com
SFDC_CLIENT_ID=
SFDC_CLIENT_SECRET=
SFDC_USERNAME=
SFDC_PASSWORD=

# 2. Groups.io — Bearer token
#    API: v1 — directadd, removemember, getmembers, getgroups
#    Used by: Mailing List Provisioning, WG Enrollment
GROUPSIO_API_TOKEN=
GROUPSIO_ORG_ID=aaif

# 3. Google Calendar — Service account JWT
#    API: Calendar v3 — events.insert, events.list, events.patch, events.delete
#    Used by: Calendar Management, Call Scheduling, WG Enrollment
GOOGLE_CALENDAR_CREDENTIALS=

GOOGLE_CALENDAR_ADMIN_EMAIL=

# 4. Discord — Bot token
#    API: Bot API v10 — guild member roles, channel access
#    Used by: WG Enrollment (channel/role provisioning)
DISCORD_BOT_TOKEN=
DISCORD_SERVER_ID=

# 5. GitHub — Personal access token
#    API: REST v3 — repos collaborators (add/remove/list)
#    Used by: WG Enrollment (repo access)
GITHUB_TOKEN=

GITHUB_ORG=aaif

# 6. LFX Platform — API key
#    API: OpenProfile v1 — elections, LFID verification, ballots
#    Used by: Elections & Voting, LFID checks
LFX_API_URL=https://api.lfx.platform/v1
LFX_API_KEY=

# 7. HubSpot — Private app API key
#    API: v3 — transactional email, templates
#    Used by: Press Release distribution, Renewal Outreach
HUBSPOT_API_KEY=

API连接器操作

赛富时 （REST v59.0）：

• POST /services/oauth2/token --身份验证
• GET /services/data/v59.0/query?q={SOQL} --查询帐户、联系人
• 自定义字段： Membership_Tier__c, Membership_Status__c, Contract_Signed_Date__c, LFID__c

Groups.io （v1）：

• POST /directadd --将成员添加到组
• POST /removemember --从组中删除成员
• GET /getmembers --列出组成员（分页）
• GET /getmember --检查单一会员资格

Google 日历 （v3）：

• POST /calendars/{id}/events --创建活动/邀请
• GET /calendars/{id}/events --列出事件
• PATCH /calendars/{id}/events/{eventId} --更新事件
• DELETE /calendars/{id}/events/{eventId} --取消事件

Discord 的中文翻译是“不和谐”或“纷争”。 （Bot API v10）：

• PUT /guilds/{id}/members/{userId}/roles/{roleId} --添加角色
• DELETE /guilds/{id}/members/{userId}/roles/{roleId} --删除角色
• GET /guilds/{id}/members --列出成员

GitHub （REST v3）：

• PUT /repos/{owner}/{repo}/collaborators/{username} --添加合作者
• DELETE /repos/{owner}/{repo}/collaborators/{username} --删除合作者
• GET /repos/{owner}/{repo}/collaborators --列出合作者

LFX平台 （v1）：

• POST /elections --创建选举
• GET /elections/{id} --获得选举资格
• GET /contacts/{id}/lfid --验证LFID
• GET /elections/{id}/ballot/{contactId} --检查投票状态

集客 （v3）：

• POST /transactional/email --从模板发送电子邮件
• GET /marketing/emails/templates --列表模板

______________________________________________________________________

建筑

src/aaif_mcp_server/
├── server.py                  # MCP server (FastMCP) — registers 48 tools, 7 resources, 3 prompts
├── config.py                  # Mock data + provisioning rules + checklist templates
├── models.py                  # Pydantic models (MemberOrg, Contact, SanctionsResult, etc.)
├── connectors/
│   ├── base.py                # Abstract base classes (BaseConnector, BaseCRMConnector, etc.)
│   ├── registry.py            # Connector registry (singleton init, env-var toggled PIS/mock)
│   ├── pis_client.py          # Shared PIS HTTP client (X-ACL auth, retry, base URL)
│   ├── pis_groupsio.py        # PIS Groups.io connector (mailing list CRUD via PIS V2)
│   ├── pis_meeting.py         # PIS Meeting connector (LFX Meeting V2 / zoomV2 API)
│   ├── pis_github.py          # PIS GitHub connector (org/repo tracking via PIS V2)
│   ├── salesforce.py          # Salesforce REST API v59 (auto-falls back to mock)
│   ├── groupsio.py            # Groups.io API v1 (legacy — auto-falls back to mock)
│   ├── calendar.py            # Google Calendar API v3 (legacy — replaced by PIS Meeting)
│   ├── discord.py             # Discord Bot API v10 (mock)
│   ├── github_connector.py    # GitHub REST API v3 (mock)
│   ├── lfx_platform.py        # LFX Platform / OpenProfile API (mock)
│   └── hubspot.py             # HubSpot Marketing API (mock)
├── tools/
│   ├── tier_validation.py     # 3 tools: validate, entitlements, anomalies
│   ├── compliance.py          # 4 tools: sanctions, tax-exempt, report, flag
│   ├── mailing_list.py        # 4 tools: provision, remove, check, remediate
│   ├── orchestrator.py        # 5 tools: onboard, status, reconcile, offboard, health
│   ├── contact_roles.py       # 5 tools: list, add, update, remove, transfer
│   ├── calendar.py            # 3 tools: provision invites, update schedule, upcoming
│   ├── wg_enrollment.py       # 5 tools: enroll, leave, list, members, eligibility
│   ├── call_scheduling.py     # 3 tools: schedule, reschedule, status
│   ├── elections.py           # 5 tools: create, candidate, voter, status, diagnose
│   ├── press_release.py       # 3 tools: draft, status, templates
│   ├── logo_brand.py          # 3 tools: validate, guidelines, upload
│   └── renewal_intelligence.py # 5 tools: renewal, engagement, churn, dashboard, outreach
└── resources/
    ├── member.py              # member:// resources (profiles, list)
    ├── checklist.py           # checklist:// resources (D1-D5 templates)
    └── rules.py               # rules:// resources (entitlements, provisioning, WGs)

模拟成员（用于测试）

许可证

Apache 2.0