Getmatter MCP Server

Matter MCP服务器

MCP（模型上下文协议）服务器 物质，稍后阅读应用程序。该服务器允许AI助手与您的Matter阅读列表进行交互——列出文章、获取文章细节和亮点，以及保存新文章。

特性

• 列出文章：浏览带有标题、作者、进度和状态的Matter阅读列表
• 获取文章详细信息：检索完整的文章信息，包括亮点和注释
• 保存文章：将新URL添加到您的Matter队列

安装

npm install
npm run build

与claude.ai（Vercel部署）一起使用

部署到Vercel，作为远程MCP服务器与claude.ai一起使用。使用OAuth风格的二维码身份验证-只需点击连接并扫描！

1.部署到Vercel


或者手动部署：

npm install -g vercel
vercel

不需要环境变量-服务器是无状态的。

2.添加到claude.ai

1. 首选 claude.ai 设置
2. 导航至 MCP服务器 （或集成）
3. 添加新的远程MCP服务器：

- 统一资源定位符: https://your-project.vercel.app/api/mcp - 授权URL: https://your-project.vercel.app/api/oauth/authorize - 令牌URL: https://your-project.vercel.app/api/oauth/token

1. 点击 连接
2. 使用手机上的Matter应用程序扫描二维码
3. 完成！您的Matter帐户现已连接

您的代币通过二维码扫描获得，并由claude.ai安全存储。

使用Claude Desktop（本地）

对于本地使用，您需要通过Obsidian插件手动获取令牌。

获取您的物质API代币

1. 安装 黑曜石
2. 安装 物质插件 来自社区插件
3. 黑曜石中的Open Matter插件设置-您将看到一个二维码
4. 在你的手机上，打开 Matter应用程序→ 个人资料→ 设置→ 已连接帐户→ 黑曜石
5. 扫描二维码
6. 在以下位置查找您的代币 .obsidian/plugins/matter/data.json

配置

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "matter": {
      "command": "node",
      "args": ["/path/to/getmatter-mcp-server/dist/index.js"],
      "env": {
        "MATTER_ACCESS_TOKEN": "your-access-token",
        "MATTER_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

可用工具

matter_list_文章

从你的Matter阅读列表中列出文章。

参数：

• limit （可选）：返回的最大文章数（默认值：20，最大值：100）

例子：

List my Matter articles

matter_get_物品

获取特定文章的详细信息。

参数：

• article_id （必填）：要检索的文章的ID

例子：

Get details for article with ID abc123

matter_save_tarticle

将新文章保存到您的Matter队列中。

参数：

• url （必填）：要保存的文章的URL

例子：

Save https://example.com/interesting-article to Matter

发展

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Run the server
npm start

API注释

该服务器使用Matter的内部API（v11），该API是从 官方黑曜石插件.API没有正式文件，可能会更改。关键端点：

• GET /library_items/highlights_feed/ -列出有亮点的文章
• POST /library_items/queue_entries/ -保存新文章
• POST /token/refresh/ -刷新访问令牌

许可证

麻省理工学院