Common Elements

Claude 的 Common Elements 插件

由 Common Elements 提供的 Claude 聊天、Cowork 和 Claude Code 插件市场。Common Elements 是面向社区协会的信息网络。

插件	功能
common-elements	托管的 Common Elements MCP 服务，以及用于调查协会、查找供应商、发起 RFP、查询法规和追踪董事会及管理变更的技能

安装

对于 Claude 聊天和 Cowork，请在 自定义 > 插件 中添加此插件市场，安装 Common Elements，然后从该插件的 连接器 选项卡进行连接。安装仅适用于你当前的 Claude 组织。

对于 Claude Code，在 shell 中运行：

claude plugin marketplace add CommonElements/common-elements-claude-plugins
claude plugin install common-elements@common-elements

或在 Claude Code 中运行：

/plugin marketplace add CommonElements/common-elements-claude-plugins
/plugin install common-elements@common-elements

然后运行 /mcp，选择 plugin:common-elements:common-elements，并使用你的 Common Elements 账户登录（OAuth）。如需自动接收新版本，请打开 /plugin，依次选择 市场、common-elements，然后启用自动更新。否则，请运行 claude plugin update common-elements@common-elements。

只想使用服务而不需要技能？运行 claude mcp add --transport http common-elements https://commonelements.com/api/mcp。其他所有客户端（网页和桌面版 Claude、ChatGPT、Cursor、VS Code、Codex）的相关说明见 https://commonelements.com/developers/mcp。

Codex 使用同一仓库：codex plugin marketplace add CommonElements/common-elements-claude-plugins。

如实介绍其功能

• 协会记录：来自各州登记处和其他公共记录的 HOA、公寓及合作公寓协会信息。免费访问可获取公共记录的基本信息；更深入的部分（管理、负责人、变更动态、建筑安全、灾害风险）需要付费 Data 计划。各州和县的覆盖范围有所不同，每条响应都会注明数据来源。
• 法规：提供美国社区协会法规的全文搜索和条文内容，并可只读扫描为此明确提供的文本，检查合规情况。此信息仅供参考，不构成法律建议。
• 供应商和 RFP：提供来自各州许可委员会记录的承包商及其他持证公司信息、许可证核验，以及用于发布工作和审核提案的 RFP Hub（草稿为私密内容；发布前需要你确认）。可搜索的 Common Elements 已验证供应商档案数量不多，但仍在增加；其中仅包含已完成验证的供应商。
• Common Elements 可与协会已在使用的管理和会计软件互补，但它本身不是管理或会计软件。

数据与隐私

MCP 服务绝不会返回个人的联系方式（电子邮件、电话、邮寄地址），例如董事会成员、负责人和持证人员的联系方式。董事会和负责人数据仅包括公共记录中的姓名和职务。服务会存储请求的账户内容，并在你的账户处于开放状态期间保留使用日志和操作日志。插件 README 介绍了数据传输、保留和撤销。隐私政策：https://commonelements.com/privacy。问题请联系：[email protected]。

发布（维护者）

1. 修改 plugins/common-elements/ 下的插件。技能必须使用线上服务中已有的工具名称（Common Elements 应用中的 apps/web/app/api/[transport]/_lib/）；如果在那里重命名工具，必须在同一版本中更新技能。
2. 更新 plugins/common-elements/.claude-plugin/plugin.json（以及它旁边的 Codex plugin.json）中的 version。版本号只存在于插件清单中，绝不会放在 marketplace.json 中。用户会一直使用旧版本，直到它更新。
3. claude plugin validate . 和 claude plugin validate --strict plugins/common-elements 必须通过。CI 会运行这两项检查。
4. 从隔离配置中的本地检出安装，并确认技能和 MCP 服务均已加载：

   export CLAUDE_CONFIG_DIR=$(mktemp -d)
   claude plugin marketplace add ./
   claude plugin install common-elements@common-elements
   claude plugin details common-elements@common-elements
   

5. 运行 claude plugin eval plugins/common-elements --no-publish 并检查有／无结果。捆绑的断连场景用于验证安全回退行为；它们不能替代通过 MCP Inspector 和 Claude 进行的实时工具测试，也不能替代在每个受支持平台上的测试。
6. 提交 PR，并在所需证据通过后合并。也可以选择从插件目录运行 claude plugin tag --push。

绝不要重命名已发布的插件。如果必须重命名，请在 marketplace.json 的 renames 中添加旧名称（{"old-name": "new-name"}）。该映射只能追加：绝不要删除条目，否则使用旧名称的用户将无法再找到该插件。

许可证

本仓库中的文件采用 MIT 许可证。Common Elements 本身受其条款约束。