mcp-moncompte

Name: mcp-moncompte
Author: waddou

远程服务

moncompte.org搜索与检索011 周前更新

代码仓库访问官网

关于 mcp-moncompte

mcp-moncompte 是只读 MCP 服务，让 AI Agent 搜索和读取 moncompte.org 的账户访问指南。它读取网站公开索引，只提供已发布内容。

主要功能

01搜索指南标题和文章正文
02通过 slug 获取完整文章
03以资源形式提供网站概览
04仅提供已发布内容
05支持 Streamable HTTP 和 SSE

适用场景

01查找在线账户访问指南
02阅读某项服务的完整操作说明
03让 AI Agent 搜索 moncompte.org 内容

MCP 相关

提供 `search_articles` 和 `get_article` 工具，以及 `moncompte://about` 资源。MCP 客户端通过 `/mcp` Streamable HTTP 端点或 `/sse` 连接。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp-moncompte.wadie.workers.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http waddou-mcp-moncompte https://mcp-moncompte.wadie.workers.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"waddou-mcp-moncompte":{"type":"http","url":"https://mcp-moncompte.wadie.workers.dev/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"waddou-mcp-moncompte":{"type":"http","url":"https://mcp-moncompte.wadie.workers.dev/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"waddou-mcp-moncompte":{"type":"http","url":"https://mcp-moncompte.wadie.workers.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"waddou-mcp-moncompte":{"serverUrl":"https://mcp-moncompte.wadie.workers.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

mcp-moncompte

只读 MCP（Model Context Protocol） 服务，通过 Cloudflare Workers 向 AI Agent（Claude 等）提供 moncompte.org 的文章目录。

技术栈：TypeScript + Cloudflare Workers + Durable Objects + 官方 MCP SDK + Zod
数据源：静态网站 moncompte.org（Astro / Cloudflare Pages）的公开端点——不使用 WP REST。搜索和 get_article 均读取 /search-index.json （在构建时生成的全文索引：标题、slug、描述、完整正文）。about 资源代理 /llms.txt。无需任何密钥。
缓存：Cloudflare 边缘缓存，每次调用缓存 1 小时

依赖项：search_articles 和 get_article 依赖 https://moncompte.org/search-index.json，该索引由 Astro 网站生成（端点 src/pages/search-index.json.js）。索引已经排除 未来日期的文章（isPublished）和草稿（draft）——因此 MCP 只能看到实际已上线的内容。每次构建 / 部署网站时都会重新生成索引。

暴露的工具和资源

类型	名称	作用
工具	`search_articles`	按关键词搜索（标题、slug、URL、摘要）
工具	`get_article`	获取文章完整内容（按 slug）
资源	`moncompte://about`	代理 moncompte.org 的 `llms.txt`

端点

/sse — Server-Sent Events（旧版客户端）
/mcp — Streamable HTTP（推荐的传输方式）
速率限制：每个 IP 每 60 秒 100 个请求（Workers 原生绑定）
Durable Object：NoticielMCP（McpAgent 类）

开发

npm install
npm run dev          # wrangler dev (local)
npm run typecheck    # tsc --noEmit

部署

npx wrangler login   # une fois (compte Cloudflare)
npm run deploy       # wrangler deploy

速率限制绑定（[[unsafe.bindings]] 类型为 ratelimit）要求 Wrangler ≥ 4.36。 Durable Object McpAgent 使用 SQLite 存储（迁移 new_sqlite_classes）。

连接 MCP 客户端

URL：https://mcp-moncompte.<ton-sous-domaine>.workers.dev/mcp（或 /sse）
Claude Desktop / 其他客户端：通过 mcp-remote：

{
  "mcpServers": {
    "moncompte": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp-moncompte.<sous-domaine>.workers.dev/sse"]
    }
  }
}

备注

不执行任何写入操作：此服务只读取 moncompte.org 的公开 API。
agents 和 @modelcontextprotocol/sdk 的版本迭代很快：如果构建出错，请运行 npm install agents@latest @modelcontextprotocol/sdk@latest。