hamir

hamir MCP 服务

通过 hamir 和你选择的 AI Agent，随时了解你喜爱的话题。

• “今天大多数来源都在报道哪些故事？”
• “The Kyiv Independent 最近发表了什么？”
• “给我看看 hamir 关于科技的精选包。”
• “把这个保存到 hamir，并添加备注：周五前阅读。”

工具

这些工具都不会更改 hamir 服务器上的任何内容。

工具	返回内容
search	与查询匹配的文章，每篇文章都有可供 fetch 使用的 ID
fetch	一篇文章：标题、来源、日期、链接，以及在允许的情况下提供的摘要片段
search_sources	按名称、网站或主题搜索新闻网站、杂志和博客
get_source_articles	某个来源的最新文章
todays_coverage	当前最多来源正在报道的故事
list_packs	hamir 精选的来源包
get_pack	某个来源包中的来源
save_articles	一个链接，可保存多达 50 篇文章并添加备注；在应用中确认后生效

返回的文章包含标题、来源、日期和链接。只有在来源允许 AI 摘要时，才会附上信息流自带的摘要片段。绝不会返回文章正文，每次调用的结果数量也有限制。

连接

服务器地址为 https://hamir.app/mcp（Streamable HTTP，无需登录）。将该 URL 添加到任意 MCP 客户端即可。

客户端	操作
ChatGPT	开启开发者模式，然后选择 Plugins → + → 输入服务器 URL，选择 No Authentication
Claude（网页端和移动端）	Settings → Connectors → Add custom connector，无需登录
Claude Code	claude mcp add -t http -s user hamir https://hamir.app/mcp
Codex	codex mcp add hamir --url https://hamir.app/mcp
Cursor、VS Code、Gemini CLI、Zed 及另外 6 个客户端	docs/clients.md

桌面扩展

对于 Claude Desktop，此仓库还会构建一个一键安装扩展：从最新版本下载 hamir.mcpb 并打开即可。它是连接到同一服务器的小型本地桥接程序，因此无需更新即可使用新工具，还会添加语言和错误报告设置。

变量	用途
HAMIR_LANGUAGE	来源包名称和标签使用的语言，例如 uk
HAMIR_ERROR_REPORTS	true 表示发送错误报告；否则关闭
HAMIR_MCP_URL	要转发到的其他服务器，用于开发

开发

npm install
npm run typecheck && npm test
npm run sync-manifest    # copy tools and languages from the server into manifest.json
npm run pack             # build hamir.mcpb

隐私政策

完整政策请访问 hamir.app/privacy。

• **收集内容：**每次工具调用的参数（例如搜索查询）和语言设置。不收集账号、姓名、电子邮件、Cookie 或设备标识符。不会发送你的对话。
• **用途和存储：**参数仅用于响应调用，不会存储。你的 IP 地址用于速率限制，计数器会在五分钟内过期；IP 地址还会与用户代理一起写入 hamir 的请求日志。
• **共享：**无。你可以选择发送匿名错误报告（在扩展程序的设置中启用“发送错误报告”，或设置 HAMIR_ERROR_REPORTS=true），报告会发送到 hamir 自托管的跟踪器，不包含你的 IP 地址、Cookie 或搜索内容。
• **保留期限：**不会保留参数。请求日志（IP 地址、用户代理和路径，不含参数）会在 30 天后删除，错误报告会在 90 天后删除。
• **联系方式：**[email protected]

许可证

代码采用 MIT 许可证。hamir 名称和徽标（icon.png）不在许可范围内：它们用于标识 hamir 应用，分支项目必须使用自己的名称和徽标。