{
"canonical_name": "modelcontextprotocol/servers",
"compilation_id": "pack_ac2cfdce83d44ddeb5dfda54ba00770d",
"created_at": "2026-05-11T08:51:57.270208+00:00",
"created_by": "project-pack-compiler",
"feedback": {
"carrier_selection_notes": [
"viable_asset_types=mcp_config, recipe, host_instruction, eval, preflight",
"recommended_asset_types=mcp_config, recipe, host_instruction, eval, preflight"
],
"evidence_delta": {
"confirmed_claims": [
"identity_anchor_present",
"capability_and_host_targets_present",
"install_path_declared_or_better"
],
"missing_required_fields": [],
"must_verify_forwarded": [
"Run or inspect `npx -y @modelcontextprotocol/server-memory` in an isolated environment.",
"Confirm the project exposes the claimed capability to at least one target host."
],
"quickstart_execution_scope": "allowlisted_sandbox_smoke",
"sandbox_command": "npx -y @modelcontextprotocol/server-memory",
"sandbox_container_image": "node:22-slim",
"sandbox_execution_backend": "docker",
"sandbox_planner_decision": "deterministic_isolated_install",
"sandbox_validation_id": "sbx_86b8871ec3e8471abaab40e9ac04fe9f"
},
"feedback_event_type": "project_pack_compilation_feedback",
"learning_candidate_reasons": [],
"template_gaps": []
},
"identity": {
"canonical_id": "project_76326ae04ef28e5085469316723a893e",
"canonical_name": "modelcontextprotocol/servers",
"homepage_url": null,
"license": "unknown",
"repo_url": "https://github.com/modelcontextprotocol/servers",
"slug": "servers",
"source_packet_id": "phit_109744362e1e442e9582d8e5ff9242aa",
"source_validation_id": "dval_e719397ea4654b7d9aa9c05ded209583"
},
"merchandising": {
"best_for": "需要软件开发与交付能力，并使用 local_cli的用户",
"github_forks": 10671,
"github_stars": 85548,
"one_liner_en": "Model Context Protocol Servers",
"one_liner_zh": "Model Context Protocol Servers",
"primary_category": {
"category_id": "software-development",
"confidence": "medium",
"name_en": "Software Development",
"name_zh": "软件开发与交付",
"reason": "matched_keywords:git, cli"
},
"target_user": "使用 local_cli 等宿主 AI 的用户",
"title_en": "servers",
"title_zh": "servers 能力包",
"visible_tags": [
{
"label_en": "MCP Tools",
"label_zh": "MCP 工具",
"source": "repo_evidence_project_characteristics",
"tag_id": "product_domain-mcp-tools",
"type": "product_domain"
},
{
"label_en": "Knowledge Base Q&A",
"label_zh": "知识库问答",
"source": "repo_evidence_project_characteristics",
"tag_id": "user_job-knowledge-base-q-a",
"type": "user_job"
},
{
"label_en": "Workflow Automation",
"label_zh": "流程自动化",
"source": "repo_evidence_project_characteristics",
"tag_id": "core_capability-workflow-automation",
"type": "core_capability"
},
{
"label_en": "Node-based Workflow",
"label_zh": "节点式流程编排",
"source": "repo_evidence_project_characteristics",
"tag_id": "workflow_pattern-node-based-workflow",
"type": "workflow_pattern"
},
{
"label_en": "Evaluation Suite",
"label_zh": "评测体系",
"source": "repo_evidence_project_characteristics",
"tag_id": "selection_signal-evaluation-suite",
"type": "selection_signal"
}
]
},
"packet_id": "phit_109744362e1e442e9582d8e5ff9242aa",
"page_model": {
"artifacts": {
"artifact_slug": "servers",
"files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json",
"REPO_INSPECTION.md",
"CAPABILITY_CONTRACT.json",
"EVIDENCE_INDEX.json",
"CLAIM_GRAPH.json"
],
"required_files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json"
]
},
"detail": {
"capability_source": "Project Hit Packet + DownstreamValidationResult",
"commands": [
{
"command": "npx -y @modelcontextprotocol/server-memory",
"label": "Node.js / npx · 官方安装入口",
"source": "https://github.com/modelcontextprotocol/servers#readme",
"verified": true
}
],
"display_tags": [
"MCP 工具",
"知识库问答",
"流程自动化",
"节点式流程编排",
"评测体系"
],
"eyebrow": "软件开发与交付",
"glance": [
{
"body": "判断自己是不是目标用户。",
"label": "最适合谁",
"value": "需要软件开发与交付能力，并使用 local_cli的用户"
},
{
"body": "先理解能力边界，再决定是否继续。",
"label": "核心价值",
"value": "Model Context Protocol Servers"
},
{
"body": "未完成验证前保持审慎。",
"label": "继续前",
"value": "publish to Doramagic.ai project surfaces"
}
],
"guardrail_source": "Boundary & Risk Card",
"guardrails": [
{
"body": "Prompt Preview 只展示流程，不证明项目已安装或运行。",
"label": "Check 1",
"value": "不要把试用当真实运行"
},
{
"body": "local_cli",
"label": "Check 2",
"value": "确认宿主兼容"
},
{
"body": "publish to Doramagic.ai project surfaces",
"label": "Check 3",
"value": "先隔离验证"
}
],
"mode": "mcp_config, recipe, host_instruction, eval, preflight",
"pitfall_log": {
"items": [
{
"body": "README/documentation is current enough for a first validation pass.",
"category": "能力坑",
"evidence": [
"capability.assumptions | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | README/documentation is current enough for a first validation pass."
],
"severity": "medium",
"suggested_check": "将假设转成下游验证清单。",
"title": "能力判断依赖假设",
"user_impact": "假设不成立时，用户拿不到承诺的能力。"
},
{
"body": "未记录 last_activity_observed。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | last_activity_observed missing"
],
"severity": "medium",
"suggested_check": "补 GitHub 最近 commit、release、issue/PR 响应信号。",
"title": "维护活跃度未知",
"user_impact": "新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"downstream_validation.risk_items | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "进入安全/权限治理复核队列。",
"title": "下游验证发现风险项",
"user_impact": "下游已经要求复核，不能在页面中弱化。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"risks.scoring_risks | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "把风险写入边界卡，并确认是否需要人工复核。",
"title": "存在评分风险",
"user_impact": "风险会影响是否适合普通用户安装。"
},
{
"body": "issue_or_pr_quality=unknown。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | issue_or_pr_quality=unknown"
],
"severity": "low",
"suggested_check": "抽样最近 issue/PR，判断是否长期无人处理。",
"title": "issue/PR 响应质量未知",
"user_impact": "用户无法判断遇到问题后是否有人维护。"
},
{
"body": "release_recency=unknown。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | release_recency=unknown"
],
"severity": "low",
"suggested_check": "确认最近 release/tag 和 README 安装命令是否一致。",
"title": "发布节奏不明确",
"user_impact": "安装命令和文档可能落后于代码，用户踩坑概率升高。"
}
],
"source": "ProjectPitfallLog + ProjectHitPacket + validation + community signals",
"summary": "发现 6 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：能力坑 - 能力判断依赖假设。",
"title": "踩坑日志"
},
"snapshot": {
"contributors": 1025,
"forks": 10671,
"license": "unknown",
"note": "GitHub API 快照，非实时质量证明；用于开工前背景判断。",
"stars": 85548,
"open_issues": 439,
"pushed_at": null
},
"source_url": "https://github.com/modelcontextprotocol/servers",
"steps": [
{
"body": "不安装项目，先体验能力节奏。",
"code": "preview",
"title": "先试 Prompt"
},
{
"body": "理解输入、输出、失败模式和边界。",
"code": "manual",
"title": "读说明书"
},
{
"body": "把上下文交给宿主 AI 继续工作。",
"code": "context",
"title": "带给 AI"
},
{
"body": "进入主力环境前先完成安装入口与风险边界验证。",
"code": "verify",
"title": "沙箱验证"
}
],
"subtitle": "Model Context Protocol Servers",
"title": "servers 能力包",
"trial_prompt": "# servers - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 servers 的“安装前体验版”。\n这不是项目介绍、不是评价报告、不是 README 总结。你的任务是让我用最小成本体验它的核心服务。\n\n我的试用任务：我想用它完成一个真实的软件开发与交付任务。\n我常用的宿主 AI：Local CLI\n\n【体验目标】\n围绕我的真实任务，现场演示这个项目如何把输入转成 示例引导, 判断线索。重点是让我感受到工作方式，而不是给我项目背景。\n\n【业务流约束】\n- 你必须像一个正在提供服务的项目能力包，而不是像一个讲解员。\n- 每一轮只推进一个步骤；提出问题后必须停下来等我回答。\n- 每一步都必须让我感受到一个具体服务动作：澄清、整理、规划、检查、判断或收尾。\n- 每一步都要说明：当前目标、你需要我提供什么、我回答后你会产出什么。\n- 不要安装、不要运行命令、不要写代码、不要声称测试通过、不要声称已经修改文件。\n- 需要真实安装或宿主加载后才能验证的内容，必须明确说“这一步需要安装后验证”。\n- 如果我说“用示例继续”，你可以用虚构示例推进，但仍然不能声称真实执行。\n\n【可体验服务能力】\n- 安装前能力预览: Model Context Protocol Servers 输入：用户任务, 当前 AI 对话上下文；输出：示例引导, 判断线索。\n\n【必须安装后才可验证的能力】\n- 命令行启动或安装流程: 项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 输入：终端环境, 包管理器, 项目依赖；输出：安装结果, 列表/更新/运行结果。\n\n【核心服务流】\n请严格按这个顺序带我体验。不要一次性输出完整流程：\n1. page-1：项目简介。围绕“项目简介”模拟一次用户任务，不展示安装或运行结果。\n2. page-2：仓库结构与构建系统。围绕“仓库结构与构建系统”模拟一次用户任务，不展示安装或运行结果。\n3. page-3：Everything 服务器架构。围绕“Everything 服务器架构”模拟一次用户任务，不展示安装或运行结果。\n4. page-5：Filesystem 服务器。围绕“Filesystem 服务器”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. page-1\n输入：用户提供的“项目简介”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. page-2\n输入：用户提供的“仓库结构与构建系统”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. page-3\n输入：用户提供的“Everything 服务器架构”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. page-5\n输入：用户提供的“Filesystem 服务器”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / page-1：Step 1 必须围绕“项目简介”形成一个小中间产物，并等待用户确认。\n- Step 2 / page-2：Step 2 必须围绕“仓库结构与构建系统”形成一个小中间产物，并等待用户确认。\n- Step 3 / page-3：Step 3 必须围绕“Everything 服务器架构”形成一个小中间产物，并等待用户确认。\n- Step 4 / page-5：Step 4 必须围绕“Filesystem 服务器”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/modelcontextprotocol/servers\n- https://github.com/modelcontextprotocol/servers#readme\n- README.md\n- package.json\n- CLAUDE.md\n- tsconfig.json\n- scripts/release.py\n- src/everything/server/index.ts\n- src/everything/README.md\n- src/everything/docs/architecture.md\n- src/everything/docs/structure.md\n- src/everything/docs/features.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 servers 的核心服务。\n2. 当前步骤：明确进入 Step 1，并说明这一步要解决什么。\n3. 你会如何服务我：说明你会先改变我完成任务的哪个动作。\n4. 只问我 3 个问题，然后停下等待回答。\n\n首次回复禁止输出：后续完整流程、证据清单、安装命令、项目评价、营销文案、已经安装或运行的说法。\n\nStep 1 / brainstorming 的二轮协议：\n- 我回答首次三问后，你仍然停留在 Step 1 / brainstorming，不要进入 Step 2。\n- 第二次回复必须产出 6 个部分：澄清后的任务定义、成功标准、边界条件、\n 2-3 个可选方案、每个方案的权衡、推荐方案。\n- 第二次回复最后必须问我是否确认推荐方案；只有我明确确认后，才能进入下一步。\n- 第二次回复禁止输出 git worktree、代码计划、测试文件、命令或真实执行结果。\n\n后续对话规则：\n- 我回答后，你先完成当前步骤的中间产物并等待确认；只有我确认后，才能进入下一步。\n- 每一步都要生成一个小的中间产物，例如澄清后的目标、计划草案、测试意图、验证清单或继续/停止判断。\n- 所有演示都写成“我会建议/我会引导/这一步会形成”，不要写成已经真实执行。\n- 不要声称已经测试通过、文件已修改、命令已运行或结果已产生。\n- 如果某个能力必须安装后验证，请直接说“这一步需要安装后验证”。\n- 如果证据不足，请明确说“证据不足”，不要补事实。\n```\n",
"voices": [
{
"body": "来源平台：github。github/github_issue: The filesystem server stopped working with the OpenAI Agent SDK.（https://github.com/modelcontextprotocol/servers/issues/3051）；github/github_issue: Filesystem extension: Frequent timeout or outright failures since claude（https://github.com/modelcontextprotocol/servers/issues/3281）；github/github_issue: filesystem MCP server doesn't support legal Windows pathnames in claude_（https://github.com/modelcontextprotocol/servers/issues/447）；github/github_issue: Latest release of @modelcontextprotocol/server-filesystem is not on npmj（https://github.com/modelcontextprotocol/servers/issues/4130）；github/github_issue: Filesystem server canonicalizes configured Windows mapped-drive paths to（https://github.com/modelcontextprotocol/servers/issues/4129）；github/github_issue: Add baselings-mcp — 42 DeFi tools for Base chain (swaps, reactor burns, （https://github.com/modelcontextprotocol/servers/issues/4127）；github/github_issue: confusing documentation（https://github.com/modelcontextprotocol/servers/issues/521）；github/github_issue: memory: safer persistence defaults, atomic writes, quotas, redaction, an（https://github.com/modelcontextprotocol/servers/issues/4117）；github/github_issue: puppeteer: update old MCP SDK and add browser-automation guardrails by d（https://github.com/modelcontextprotocol/servers/issues/4118）；github/github_issue: Reference implementation: self-evolving macOS MCP server (Swift, 71 tool（https://github.com/modelcontextprotocol/servers/issues/4126）；github/github_issue: Schema quality: missing property descriptions across official MCP server（https://github.com/modelcontextprotocol/servers/issues/3669）。这些是项目级外部声音，不作为单独质量证明。",
"items": [
{
"kind": "github_issue",
"source": "github",
"title": "The filesystem server stopped working with the OpenAI Agent SDK.",
"url": "https://github.com/modelcontextprotocol/servers/issues/3051"
},
{
"kind": "github_issue",
"source": "github",
"title": "Filesystem extension: Frequent timeout or outright failures since claude",
"url": "https://github.com/modelcontextprotocol/servers/issues/3281"
},
{
"kind": "github_issue",
"source": "github",
"title": "filesystem MCP server doesn't support legal Windows pathnames in claude_",
"url": "https://github.com/modelcontextprotocol/servers/issues/447"
},
{
"kind": "github_issue",
"source": "github",
"title": "Latest release of @modelcontextprotocol/server-filesystem is not on npmj",
"url": "https://github.com/modelcontextprotocol/servers/issues/4130"
},
{
"kind": "github_issue",
"source": "github",
"title": "Filesystem server canonicalizes configured Windows mapped-drive paths to",
"url": "https://github.com/modelcontextprotocol/servers/issues/4129"
},
{
"kind": "github_issue",
"source": "github",
"title": "Add baselings-mcp — 42 DeFi tools for Base chain (swaps, reactor burns, ",
"url": "https://github.com/modelcontextprotocol/servers/issues/4127"
},
{
"kind": "github_issue",
"source": "github",
"title": "confusing documentation",
"url": "https://github.com/modelcontextprotocol/servers/issues/521"
},
{
"kind": "github_issue",
"source": "github",
"title": "memory: safer persistence defaults, atomic writes, quotas, redaction, an",
"url": "https://github.com/modelcontextprotocol/servers/issues/4117"
},
{
"kind": "github_issue",
"source": "github",
"title": "puppeteer: update old MCP SDK and add browser-automation guardrails by d",
"url": "https://github.com/modelcontextprotocol/servers/issues/4118"
},
{
"kind": "github_issue",
"source": "github",
"title": "Reference implementation: self-evolving macOS MCP server (Swift, 71 tool",
"url": "https://github.com/modelcontextprotocol/servers/issues/4126"
},
{
"kind": "github_issue",
"source": "github",
"title": "Schema quality: missing property descriptions across official MCP server",
"url": "https://github.com/modelcontextprotocol/servers/issues/3669"
}
],
"status": "已收录 11 条来源",
"title": "社区讨论"
}
]
},
"homepage_card": {
"category": "软件开发与交付",
"desc": "Model Context Protocol Servers",
"effort": "安装已验证",
"forks": 10649,
"icon": "code",
"name": "servers 能力包",
"risk": "可发布",
"slug": "servers",
"stars": 85356,
"tags": [
"MCP 工具",
"知识库问答",
"流程自动化",
"节点式流程编排",
"评测体系"
],
"thumb": "gray",
"type": "MCP 配置"
},
"manual": {
"markdown": "# https://github.com/modelcontextprotocol/servers 项目说明书\n\n生成时间：2026-05-11 07:54:27 UTC\n\n## 目录\n\n- [项目简介](#page-1)\n- [仓库结构与构建系统](#page-2)\n- [Everything 服务器架构](#page-3)\n- [传输层与通信协议](#page-4)\n- [Filesystem 服务器](#page-5)\n- [Memory 服务器](#page-6)\n- [Sequential Thinking 服务器](#page-7)\n- [Everything 服务器扩展指南](#page-8)\n- [Fetch 服务器](#page-9)\n- [Git 服务器](#page-10)\n\n\n\n## 项目简介\n\n### 相关页面\n\n相关主题：[仓库结构与构建系统](#page-2), [Filesystem 服务器](#page-5), [Fetch 服务器](#page-9)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/modelcontextprotocol/servers/blob/main/README.md)\n- [package.json](https://github.com/modelcontextprotocol/servers/blob/main/package.json)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n \n\n# 项目简介\n\n## 项目概述\n\nModel Context Protocol Servers（简称 MCP Servers）是一个开源的服务器集合仓库，为 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 提供标准化的工具、资源和提示实现。该项目由 Model Context Protocol 团队维护，旨在为 AI 助手（如 Claude）提供可扩展的上下文访问能力。\n\n项目仓库地址：`https://github.com/modelcontextprotocol/servers`\n\n资料来源：[README.md]()\n\n## 核心功能\n\nMCP Servers 提供了多种类型的服务器实现，使 AI 模型能够：\n\n| 功能类型 | 说明 |\n|---------|------|\n| **文件系统访问** | 读写本地文件、目录操作、文件搜索 |\n| **网络内容获取** | 抓取网页内容、支持 robots.txt 配置 |\n| **时间与时区** | 获取当前时间、时区转换 |\n| **知识图谱存储** | 实体关系管理、持久化记忆 |\n| **通用工具** | 综合测试服务器 |\n| **顺序推理** | 结构化思维推理能力 |\n\n资料来源：[CLAUDE.md]()\n\n## 技术架构\n\n### 服务器类型分布\n\n项目包含两大技术栈的服务器实现：\n\n```mermaid\ngraph TD\n A[MCP Servers 仓库] --> B[TypeScript 服务器]\n A --> C[Python 服务器]\n \n B --> B1[everything]\n B --> B2[filesystem]\n B --> B3[memory]\n B --> B4[sequential-thinking]\n \n C --> C1[fetch]\n C --> C2[time]\n```\n\n### 目录结构\n\n```\nservers/\n├── src/\n│ ├── everything/ # TypeScript 综合测试服务器\n│ ├── filesystem/ # TypeScript 文件系统服务器\n│ ├── memory/ # TypeScript 知识图谱服务器\n│ ├── sequential-thinking/ # TypeScript 顺序推理服务器\n│ ├── fetch/ # Python 网页抓取服务器\n│ └── time/ # Python 时间服务器\n├── README.md\n├── package.json\n└── CLAUDE.md\n```\n\n资料来源：[README.md]()\n\n## 支持的客户端\n\nMCP Servers 可与多种 AI 客户端集成：\n\n| 客户端 | 支持的安装方式 |\n|--------|---------------|\n| **Claude Desktop** | uvx、pip、npm/npx、Docker |\n| **VS Code** | 一键安装按钮、uvx、npx |\n| **Zed** | uvx、pip |\n| **Zencoder** | uvx |\n| **Codex CLI** | npx |\n\n资料来源：[src/fetch/README.md](), [src/filesystem/README.md](), [src/time/README.md]()\n\n## 开发规范\n\n### TypeScript 服务器要求\n\n| 规范项 | 要求 |\n|--------|------|\n| 目标环境 | ES2022, Node16 |\n| 模块系统 | ES modules |\n| 类型检查 | 严格模式 |\n| 测试框架 | vitest + @vitest/coverage-v8 |\n| 输入验证 | Zod schemas |\n| 缩进 | 2 空格 |\n| 命名规范 | 变量/函数 camelCase，类型/类 PascalCase，常量 UPPER_CASE |\n| 文件命名 | kebab-case |\n| 工具命名 | 动词优先 (如 `get-file-info`) |\n\n### Python 服务器要求\n\n| 规范项 | 要求 |\n|--------|------|\n| Python 版本 | >= 3.10 |\n| 构建系统 | hatchling |\n| 包管理器 | uv |\n| 测试框架 | pytest |\n| 类型检查 | pyright |\n| 代码检查 | ruff |\n\n资料来源：[CLAUDE.md]()\n\n## 快速开始\n\n### 使用 uvx 运行（推荐）\n\n```json\n{\n \"mcpServers\": {\n \"server-name\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-name\"]\n }\n }\n}\n```\n\n### 使用 Docker 运行\n\n```json\n{\n \"mcpServers\": {\n \"server-name\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"mcp/server-name\"]\n }\n }\n}\n```\n\n### 本地开发\n\n```bash\n# TypeScript 服务器\ncd src/\nnpm install\nnpm run build\n\n# Python 服务器\ncd src/\nuv sync --frozen --all-extras --dev\nuv run pytest\n```\n\n资料来源：[CLAUDE.md](), [src/fetch/README.md]()\n\n## 主要服务器介绍\n\n### 文件系统服务器 (filesystem)\n\n提供安全的本地文件系统访问能力，支持以下工具：\n\n| 工具名称 | 功能 |\n|----------|------|\n| `read_file` | 读取单个文件内容 |\n| `read_multiple_files` | 批量读取多个文件 |\n| `write_file` | 创建或覆盖文件 |\n| `edit_file` | 编辑文件内容 |\n| `move_file` | 移动/重命名文件 |\n| `list_directory` | 列出目录内容 |\n| `search_files` | 搜索文件 |\n| `get_file_info` | 获取文件元信息 |\n\n文件系统服务器支持配置只读目录，通过 `ro` 标志限制写入权限。\n\n资料来源：[src/filesystem/README.md]()\n\n### 时间服务器 (time)\n\n提供时间和时区相关功能：\n\n- `get_current_time`: 获取当前时间（支持指定时区）\n- `convert_time`: 时区时间转换\n\n支持通过 `--local-timezone` 参数自定义本地时区。\n\n资料来源：[src/time/README.md]()\n\n### 记忆服务器 (memory)\n\n基于知识图谱的持久化存储系统：\n\n| 工具名称 | 功能 |\n|----------|------|\n| `create_entities` | 创建实体 |\n| `create_relations` | 创建实体关系 |\n| `add_observations` | 添加实体观察 |\n| `delete_entities` | 删除实体 |\n| `delete_observations` | 删除观察记录 |\n\n存储格式为 JSONL，可通过 `MEMORY_FILE_PATH` 环境变量自定义存储路径。\n\n资料来源：[src/memory/README.md]()\n\n## 配置示例\n\n### Claude Desktop 配置\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"${workspaceFolder}\"]\n },\n \"fetch\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_fetch\"]\n }\n }\n}\n```\n\n### VS Code 配置\n\n通过一键安装按钮或手动配置 JSON：\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"]\n }\n }\n}\n```\n\n### Windows 特殊配置\n\nWindows 系统可能需要设置环境变量解决字符编码问题：\n\n```json\n{\n \"mcpServers\": {\n \"server-name\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-name\"],\n \"env\": {\n \"PYTHONIOENCODING\": \"utf-8\"\n }\n }\n }\n}\n```\n\n资料来源：[src/fetch/README.md](), [src/filesystem/README.md]()\n\n## 许可协议\n\n本项目采用 MIT License 开源许可协议，允许自由使用、修改和分发软件。\n\n资料来源：[src/sequentialthinking/README.md](), [src/filesystem/README.md]()\n\n## 参与贡献\n\n欢迎提交 Pull Request 贡献代码、修复问题或增强功能。项目接受以下类型的贡献：\n\n- 错误修复\n- 可用性改进\n- 新功能开发\n- 文档完善\n\n建议查看其他 MCP 服务器的实现模式和最佳实践作为参考。\n\n资料来源：[src/fetch/README.md](), [CLAUDE.md]()\n\n---\n\n\n\n## 仓库结构与构建系统\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Everything 服务器架构](#page-3)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [package.json](https://github.com/modelcontextprotocol/servers/blob/main/package.json)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n- [src/everything/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/package.json)\n- [src/memory/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/package.json)\n- [src/filesystem/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/package.json)\n- [src/sequentialthinking/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/package.json)\n \n\n# 仓库结构与构建系统\n\n## 概述\n\nModel Context Protocol (MCP) Servers 仓库是一个**多包 Monorepo**，托管于 GitHub (https://github.com/modelcontextprotocol/servers)，旨在提供标准化的 MCP 服务器实现。该仓库包含多个独立发布的 MCP 服务器，每个服务器封装特定功能域，如文件系统访问、内存管理、HTTP 请求抓取等。\n\n仓库采用 **TypeScript** 作为主要开发语言，使用 **npm** 作为包管理器和构建工具，并通过统一的构建系统确保各服务器的一致性和可维护性。\n\n## 仓库架构\n\n### 整体结构\n\nMCP Servers 仓库采用分层目录结构，每个子目录代表一个独立的 MCP 服务器包：\n\n```\nmodelcontextprotocol/servers/\n├── src/\n│ ├── everything/ # 全功能演示服务器\n│ ├── filesystem/ # 文件系统访问服务器\n│ ├── memory/ # 知识图谱内存服务器\n│ ├── fetch/ # HTTP 请求抓取服务器\n│ ├── time/ # 时间信息服务器\n│ ├── sequentialthinking/ # 顺序推理服务器\n│ └── ... # 其他服务器\n├── scripts/ # 构建和发布脚本\n├── CLAUDE.md # AI 辅助开发指南\n└── package.json # 根级配置（可选）\n```\n\n### 服务器包类型\n\n| 包名称 | 类型 | 主要语言 | 传输协议支持 |\n|--------|------|----------|--------------|\n| server-everything | 全功能演示 | TypeScript | stdio, SSE, Streamable HTTP |\n| server-filesystem | 功能型 | TypeScript | stdio |\n| server-memory | 功能型 | TypeScript | stdio |\n| server-fetch | 功能型 | Python | stdio |\n| server-time | 功能型 | Python | stdio |\n| server-sequentialthinking | 功能型 | TypeScript | stdio |\n\n## 构建系统\n\n### 构建工具链\n\n各 TypeScript 服务器使用统一的构建工具链：\n\n| 工具 | 用途 | 配置位置 |\n|------|------|----------|\n| TypeScript (tsc) | TypeScript 编译 | tsconfig.json |\n| Vitest | 单元测试与覆盖率 | vitest.config.ts |\n| shx | 跨平台 Shell 命令 | - |\n| Prettier | 代码格式化 | .prettierrc |\n\n### 标准构建流程\n\n每个 TypeScript 服务器包定义了标准化的 npm 构建脚本：\n\n```json\n{\n \"scripts\": {\n \"build\": \"tsc && shx chmod +x dist/*.js\",\n \"prepare\": \"npm run build\",\n \"watch\": \"tsc --watch\",\n \"test\": \"vitest run --coverage\"\n }\n}\n```\n\n构建流程包含以下步骤：\n\n```mermaid\ngraph TD\n A[TypeScript 源码] --> B[tsc 编译]\n B --> C{编译成功?}\n C -->|是| D[复制资源文件]\n C -->|否| E[输出错误]\n D --> F[设置可执行权限]\n F --> G[生成 dist/ 目录]\n G --> H[prepare 钩子触发]\n```\n\n**资料来源**：[src/everything/package.json:16-19]()\n\n### 包发布配置\n\n服务器包通过 npm 的标准字段定义发布信息：\n\n```json\n{\n \"name\": \"@modelcontextprotocol/server-everything\",\n \"version\": \"2.0.0\",\n \"description\": \"MCP server that exercises all the features of the MCP protocol\",\n \"type\": \"module\",\n \"bin\": {\n \"mcp-server-everything\": \"dist/index.js\"\n },\n \"files\": [\"dist\"]\n}\n```\n\n**资料来源**：[src/everything/package.json:1-12]()\n\n## 服务器注册模式\n\nMCP 服务器遵循统一的架构模式进行功能注册：\n\n### 核心注册函数\n\n| 注册函数 | 功能 | 适用服务器 |\n|----------|------|------------|\n| `registerTools(server)` | 注册工具能力 | 所有服务器 |\n| `registerResources(server)` | 注册资源能力 | 所有服务器 |\n| `registerPrompts(server)` | 注册提示模板 | 部分服务器 |\n| `registerResourceTemplates(server)` | 注册资源模板 | 部分服务器 |\n\n### 服务器初始化流程\n\n```mermaid\ngraph TD\n A[创建 McpServer 实例] --> B[加载配置参数]\n B --> C[registerTools 调用]\n C --> D[registerResources 调用]\n D --> E[registerPrompts 调用]\n E --> F[初始化传输层]\n F --> G[启动服务器]\n```\n\n**资料来源**：[CLAUDE.md:14-15]()\n\n### 工具注解规范\n\n根据 MCP 规范，工具应设置以下注解以提供语义信息：\n\n```typescript\n{\n annotations: {\n readOnlyHint: boolean, // 是否只读\n idempotentHint: boolean, // 是否幂等\n destructiveHint: boolean // 是否具有破坏性\n }\n}\n```\n\n**资料来源**：[CLAUDE.md:17-19]()\n\n## 传输层支持\n\n### 传输协议类型\n\n| 协议 | 状态 | 启动参数 | 说明 |\n|------|------|----------|------|\n| stdio | ✅ 稳定 | `stdio` | 标准输入输出，默认协议 |\n| SSE | ⚠️ 已弃用 | `sse` | Server-Sent Events，自 2025-03-26 起弃用 |\n| Streamable HTTP | ✅ 稳定 | `streamableHttp` | HTTP 流式传输，当前推荐 |\n\n### 启动命令示例\n\n```bash\n# 启动 stdio 服务器（默认）\nnpx @modelcontextprotocol/server-everything\n\n# 启动 SSE 服务器\nnpx @modelcontextprotocol/server-everything sse\n\n# 启动 Streamable HTTP 服务器\nnpx @modelcontextprotocol/server-everything streamableHttp\n```\n\n**资料来源**：[src/everything/package.json:21-23]()\n\n## 依赖管理\n\n### 核心依赖\n\n所有 TypeScript MCP 服务器共享以下核心依赖：\n\n```json\n{\n \"dependencies\": {\n \"@modelcontextprotocol/sdk\": \"^1.26.0\"\n }\n}\n```\n\n### 可选功能依赖\n\n| 服务器 | 额外依赖 | 用途 |\n|--------|----------|------|\n| filesystem | diff, glob, minimatch, zod-to-json-schema | 文件操作与模式匹配 |\n| sequentialthinking | chalk, yargs | 命令行输出与参数解析 |\n| fetch | httpx, trafilatura | HTTP 请求与内容提取 |\n| everything | cors | 跨域资源共享 |\n\n**资料来源**：[src/filesystem/package.json:26-31]()\n\n## 开发工作流\n\n### 本地开发\n\n```bash\n# 克隆仓库\ngit clone https://github.com/modelcontextprotocol/servers.git\ncd servers\n\n# 进入服务器目录\ncd src/everything\n\n# 安装依赖\nnpm install\n\n# 监听模式开发\nnpm run watch\n\n# 运行测试\nnpm test\n```\n\n### 测试框架\n\n使用 Vitest 进行测试，测试命令为：\n\n```bash\nnpm test\n# 等价于: vitest run --coverage\n```\n\n**资料来源**：[src/everything/package.json:24]()\n\n### 代码质量\n\n```bash\n# 格式化检查\nnpm run prettier:check\n\n# 自动格式化\nnpm run prettier:fix\n```\n\n## 目录结构规范\n\n### 文件命名约定\n\n| 类型 | 命名规范 | 示例 |\n|------|----------|------|\n| 文件/变量 | camelCase | `fileName.ts`, `getUserData()` |\n| 类型/类 | PascalCase | `UserProfile`, `McpServer` |\n| 常量 | UPPER_CASE | `MAX_RETRY_COUNT` |\n| 文件名（kebab-case） | kebab-case | `resource-link.ts` |\n| 工具名称 | kebab-case + 动词 | `get-annotated-message` |\n\n**资料来源**：[src/everything/AGENTS.md:4-6]()\n\n### 模块组织\n\n每个服务器遵循统一的模块划分：\n\n```\nsrc//\n├── server/ # 服务器核心逻辑\n│ ├── index.ts # 主入口\n│ └── logging.ts # 日志工具\n├── tools/ # 工具定义\n│ └── index.ts # 工具注册入口\n├── resources/ # 资源定义\n│ ├── index.ts # 资源注册入口\n│ └── subscriptions.ts # 订阅机制\n├── prompts/ # 提示模板\n│ └── index.ts # 提示注册入口\n├── docs/ # 文档资源\n├── dist/ # 编译输出\n└── package.json # 包配置\n```\n\n**资料来源**：[src/everything/AGENTS.md:15-26]()\n\n## 扩展机制\n\n### 添加新功能\n\n扩展 MCP 服务器的标准流程：\n\n1. **创建模块**：在对应目录（tools/resources/prompts）创建新文件\n2. **定义导出**：导出 `registerX(server)` 函数\n3. **更新索引**：在 `index.ts` 中导入并注册新模块\n4. **编写文档**：更新 `docs/` 目录下的相关文档\n\n```mermaid\ngraph TD\n A[创建新模块文件] --> B[定义 registerX 函数]\n B --> C[导出模块]\n C --> D[更新 index.ts 导入]\n D --> E[注册到服务器]\n E --> F[测试功能]\n F --> G[更新文档]\n```\n\n**资料来源**：[src/everything/AGENTS.md:1-13]()\n\n### 服务器工厂模式\n\n服务器工厂位于 `src/everything/server/index.ts`，负责：\n\n- 初始化时注册所有功能\n- 处理连接后设置\n- 管理生命周期\n\n```typescript\n// 工厂函数签名示例\nexport const createServer = (config: ServerConfig) => McpServer\n```\n\n## 构建系统配置示例\n\n### TypeScript 配置\n\n```json\n{\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"module\": \"ESNext\",\n \"moduleResolution\": \"bundler\",\n \"outDir\": \"./dist\",\n \"rootDir\": \"./src\",\n \"strict\": true\n }\n}\n```\n\n### NPM 脚本映射\n\n| 脚本命令 | 实际执行 | 触发时机 |\n|----------|----------|----------|\n| `npm install` | 安装依赖 | 项目初始化 |\n| `npm run build` | tsc + 权限设置 | 发布前 |\n| `npm run prepare` | npm run build | postinstall |\n| `npm run test` | vitest run --coverage | 质量检查 |\n\n**资料来源**：[src/everything/package.json:18]()\n**资料来源**：[src/memory/package.json:16]()\n\n## 快速参考\n\n### 服务器构建检查清单\n\n- [ ] TypeScript 编译无错误\n- [ ] 所有测试通过 (`npm test`)\n- [ ] 代码格式正确 (`npm run prettier:check`)\n- [ ] package.json 字段完整\n- [ ] README.md 文档更新\n- [ ] 发布版本号正确\n\n### 常用命令速查\n\n```bash\n# 构建所有更改\nnpm run build\n\n# 运行测试\nnpm test\n\n# 启动 stdio 传输\nnpm run start:stdio\n\n# 启动 SSE 传输\nnpm run start:sse\n\n# 启动 Streamable HTTP 传输\nnpm run start:streamableHttp\n```\n\n## 总结\n\nMCP Servers 仓库采用成熟的 Monorepo 架构，通过统一的 TypeScript 构建系统和标准化的模块注册模式，实现了多个 MCP 服务器的高效开发和维护。仓库设计遵循清晰的目录规范和命名约定，便于社区贡献和功能扩展。所有服务器共享核心 SDK 依赖，同时保持各自功能域的独立性，通过标准化的传输层接口与 MCP 客户端通信。\n\n---\n\n\n\n## Everything 服务器架构\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [传输层与通信协议](#page-4), [Filesystem 服务器](#page-5)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n- [src/everything/AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md)\n- [src/everything/resources/session.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/resources/session.ts)\n- [src/everything/tools/get-roots-list.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-roots-list.ts)\n- [src/filesystem/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/index.ts)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n \n\n# Everything 服务器架构\n\n## 概述\n\nEverything 服务器是 Model Context Protocol (MCP) 服务器生态中的核心组件之一，旨在提供一个功能全面的参考实现。该服务器作为一个功能展示平台，演示了 MCP 协议的各种能力，包括工具调用、资源管理、提示模板以及多种传输协议支持。Everything 服务器采用模块化架构设计，允许开发者在此基础上进行扩展和定制，以满足特定的业务需求。\n\n该服务器的核心价值在于其示范性——它展示了如何正确实现 MCP 协议的各种特性，同时也是开发新服务器时的参考模板。通过研究 Everything 服务器的架构和实现，开发者可以深入理解 MCP 协议的设计理念和最佳实践。\n\n## 架构设计原则\n\nEverything 服务器的架构设计遵循一系列明确的原则，这些原则确保了代码的可维护性、可扩展性和一致性。\n\n### 模块化组织\n\n服务器采用高度模块化的组织结构，每个功能域都有明确的职责边界。工具（Tools）、资源（Resources）和提示（Prompts）分别位于独立的目录下，通过统一的注册接口与主服务器集成。这种组织方式使得添加新功能变得简单直接，同时降低了代码耦合度，提高了测试的可覆盖性。\n\n核心模块包括：\n\n- `src/everything/tools/` - 工具实现和注册\n- `src/everything/resources/` - 资源管理和订阅\n- `src/everything/prompts/` - 提示模板定义\n- `src/everything/server/` - 服务器核心和日志\n- `src/everything/transports/` - 传输层管理\n- `src/everything/docs/` - 架构和功能文档\n\n### 扩展点机制\n\nEverything 服务器被设计为可在明确的扩展点进行定制。服务器工厂位于 `src/everything/server/index.ts`，负责在启动时注册所有功能组件，并处理连接后的设置工作。资料来源：[src/everything/AGENTS.md:1-20]()\n\n## 核心组件\n\n### 服务器工厂\n\n服务器工厂是 Everything 服务器的中央协调器，负责初始化 MCP 服务器实例并注册所有功能模块。工厂函数接收配置参数，返回配置完整的服务器实例。\n\n```typescript\n// 核心架构伪代码\nexport function createServer(config: ServerConfig): McpServer {\n const server = new McpServer(config);\n registerTools(server);\n registerResources(server);\n registerPrompts(server);\n return server;\n}\n```\n\n### 工具系统\n\n工具是 Everything 服务器提供的核心功能之一。每个工具都是一个独立的模块，遵循统一的注册模式。工具的命名规范要求使用 kebab-case 格式，并以动词开头，例如 `get-annotated-message` 而不是 `annotated-message`。资料来源：[src/everything/AGENTS.md:10-12]()\n\n#### 工具注册模式\n\n所有工具必须导出 `registerX(server)` 函数，该函数接收 MCP SDK 服务器实例并注册相应的工具。工具定义包含以下关键属性：\n\n| 属性 | 说明 | 示例 |\n|------|------|------|\n| name | 工具名称（kebab-case） | `get-file-info` |\n| description | 功能描述 | 工具用途说明 |\n| inputSchema | 输入参数 schema | Zod schema 定义 |\n| outputSchema | 输出结果 schema | 返回值结构定义 |\n| annotations | 提示注解 | readOnlyHint、idempotentHint 等 |\n\n#### 工具注解系统\n\nMCP 协议定义了工具的重要注解，用于向客户端传达工具的行为特性：\n\n| 工具名称 | readOnlyHint | idempotentHint | destructiveHint | 说明 |\n|---------|--------------|----------------|-----------------|------|\n| `read_file` | true | - | - | 纯读取操作 |\n| `read_multiple_files` | true | - | - | 批量读取 |\n| `list_directory` | true | - | - | 列表操作 |\n| `write_file` | false | true | true | 覆盖写入 |\n| `edit_file` | false | false | true | 编辑可能重复应用 |\n| `move_file` | false | false | true | 移动操作会删除源文件 |\n\n资料来源：[src/filesystem/index.ts:1-50]()\n\n### 资源系统\n\n资源系统允许服务器提供可寻址的数据内容。Everything 服务器实现了动态资源注册机制，支持文本和二进制两种资源类型。\n\n#### 资源注册流程\n\n```typescript\nexport const registerSessionResource = (\n server: McpServer,\n resource: Resource,\n type: \"text\" | \"blob\",\n payload: string\n): ResourceLink => {\n // 检查是否已存在同名资源，如存在则移除\n const existingResource = registeredResources.get(uri);\n if (existingResource) {\n existingResource.remove();\n registeredResources.delete(uri);\n }\n\n // 注册新资源\n const registeredResource = server.registerResource(\n name,\n uri,\n { mimeType, description, title, annotations, icons, _meta },\n async () => {\n return {\n contents: [resourceContent],\n };\n }\n );\n\n // 跟踪已注册资源以便后续移除\n registeredResources.set(uri, registeredResource);\n\n return { type: \"resource_link\", ...resource };\n};\n```\n\n资料来源：[src/everything/resources/session.ts:1-65]()\n\n### 提示模板\n\n提示（Prompts）为预定义的交互模板，可被客户端调用。每个提示定义包含名称、描述、参数 schema 和生成逻辑。提示模板存储在 `src/everything/prompts/` 目录下。\n\n### 订阅与更新机制\n\nEverything 服务器实现了资源订阅功能，允许客户端订阅特定资源的变化。订阅例程位于 `src/everything/resources/subscriptions.ts`，支持模拟更新推送。资料来源：[src/everything/AGENTS.md:15]()\n\n### 日志系统\n\n日志辅助模块位于 `src/everything/server/logging.ts`，提供统一的日志记录接口。日志系统与服务器核心 (`src/everything/server/index.ts`) 紧密集成，同时也应用于订阅模块。资料来源：[src/everything/AGENTS.md:16]()\n\n## 传输协议支持\n\nEverything 服务器支持多种传输协议，以适应不同的部署场景和客户端需求。\n\n### 标准输入输出 (stdio)\n\nstdio 是默认的传输方式，适用于命令行工具和本地集成场景。服务器通过标准输入输出流进行 JSON-RPC 通信。\n\n### 服务器发送事件 (SSE)\n\nSSE 传输支持服务器向客户端推送事件。启用方式：\n\n```bash\nnpx @modelcontextprotocol/server-everything sse\n```\n\n从源码运行 SSE 服务器：\n\n```bash\ncd src/everything\nnpm install\nnpm run start:sse\n```\n\n资料来源：[src/everything/README.md:1-30]()\n\n### 流式 HTTP (Streamable HTTP)\n\n流式 HTTP 传输是自 2025-03-26 起推荐的传输方式，取代了 SSE。运行命令：\n\n```bash\nnpx @modelcontextprotocol/server-everything streamableHttp\n```\n\n从源码运行：\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n资料来源：[src/everything/README.md:1-30]()\n\n```mermaid\ngraph TD\n A[客户端] --> B{传输协议选择}\n B --> C[stdio]\n B --> D[SSE]\n B --> E[Streamable HTTP]\n C --> F[标准输入输出通信]\n D --> G[HTTP + Server-Sent Events]\n E --> H[流式 HTTP 响应]\n F --> I[MCP 服务器]\n G --> I\n H --> I\n```\n\n## 目录结构\n\nEverything 服务器遵循标准的 TypeScript 项目结构，目录组织如下：\n\n```\nsrc/everything/\n├── server/\n│ ├── index.ts # 服务器工厂\n│ └── logging.ts # 日志辅助\n├── tools/\n│ ├── index.ts # 工具注册入口\n│ └── *.ts # 各工具实现\n├── resources/\n│ ├── index.ts # 资源注册入口\n│ ├── session.ts # 会话资源\n│ └── subscriptions.ts # 订阅管理\n├── prompts/\n│ ├── index.ts # 提示注册入口\n│ └── *.ts # 提示模板\n├── transports/\n│ └── *.ts # 传输协议实现\n├── docs/\n│ ├── architecture.md # 架构文档\n│ ├── structure.md # 项目结构\n│ ├── features.md # 功能说明\n│ └── extension.md # 扩展指南\n└── package.json\n```\n\n资料来源：[src/everything/AGENTS.md:1-25]()\n\n## 类型命名规范\n\nEverything 服务器对不同类型的代码元素采用了明确的命名约定，这些规范确保了代码库的一致性和可读性：\n\n| 类型 | 命名风格 | 示例 |\n|------|---------|------|\n| 变量和函数 | camelCase | `readMultipleFiles`, `getFileInfo` |\n| 类型和类 | PascalCase | `McpServer`, `ResourceLink` |\n| 常量 | UPPER_CASE | `DEFAULT_TIMEOUT`, `MAX_RETRIES` |\n| 文件名 | kebab-case | `get-roots-list.ts`, `session.ts` |\n| 注册的工具/提示/资源 | kebab-case | `get-file-info`, `list-directory` |\n\n资料来源：[src/everything/AGENTS.md:7-11]()\n\n## 扩展指南\n\n### 添加新工具\n\n添加新工具的步骤如下：\n\n1. 在 `src/everything/tools/` 目录下创建新的工具文件，命名使用 kebab-case\n2. 定义工具的 Zod schema，确保包含准确的描述和示例\n3. 导出 `registerXxx(server)` 函数\n4. 在 `tools/index.ts` 中导入并调用新工具的注册函数\n\n工具 schema 应遵循 JSON Schema 标准，包含完整的类型定义和验证规则。\n\n### 添加新资源\n\n资源扩展遵循类似的模式：\n\n1. 在 `src/everything/resources/` 下创建资源模块\n2. 实现资源内容的生成逻辑\n3. 导出注册函数并在 `resources/index.ts` 中集成\n\n### 添加新提示\n\n提示模板的添加流程：\n\n1. 在 `src/everything/prompts/` 下创建提示定义\n2. 定义提示参数 schema\n3. 实现提示内容生成函数\n4. 在 `prompts/index.ts` 中注册\n\n## MCP 协议特性演示\n\nEverything 服务器作为功能展示平台，演示了 MCP 协议的多个核心特性：\n\n### 根目录 (Roots) 支持\n\n服务器实现了根目录协议能力，通过 `get-roots-list` 工具展示根目录的使用方式。根目录由 MCP 客户端提供，可供需要文件系统访问的服务器使用。资料来源：[src/everything/tools/get-roots-list.ts:1-60]()\n\n```typescript\n// 根目录列表输出格式\nreturn {\n content: [\n {\n type: \"text\",\n text: `Current MCP Roots (${currentRoots!.length} total):\\n\\n${rootsList}\\n\\n` +\n \"Note: This server demonstrates the roots protocol capability...\"\n },\n ],\n};\n```\n\n### 资源注解\n\n服务器展示了对资源的注解支持，包括只读提示、可变性提示和唯一性提示。这些注解帮助客户端理解资源的行为特性。\n\n### 双向通信\n\n通过订阅机制，服务器可以主动向客户端推送更新，实现双向通信模式。\n\n## 构建与部署\n\n### Docker 构建\n\n```bash\ndocker build -t mcp/sequentialthinking -f src/sequentialthinking/Dockerfile .\n```\n\n### 从源码安装\n\n```bash\nnpm install -g @modelcontextprotocol/server-everything@latest\n```\n\n### 开发模式\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n## 许可证\n\nEverything MCP 服务器采用 MIT 许可证授权，这意味着用户可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n---\n\n\n\n## 传输层与通信协议\n\n### 相关页面\n\n相关主题：[Everything 服务器架构](#page-3), [Filesystem 服务器](#page-5)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/everything/transports/stdio.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/stdio.ts)\n- [src/everything/transports/sse.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/sse.ts)\n- [src/everything/transports/streamableHttp.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/streamableHttp.ts)\n- [src/everything/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/package.json)\n- [src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n- [src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n- [src/time/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md)\n \n\n# 传输层与通信协议\n\n## 概述\n\nModel Context Protocol (MCP) 服务器支持多种传输层协议，以适应不同的部署场景和客户端环境。传输层是 MCP 架构中的核心组件，负责在客户端与服务端之间建立通信通道、处理请求与响应的序列化与反序列化，以及管理连接生命周期。\n\nMCP 服务器的传输层设计遵循以下核心原则：\n\n| 设计原则 | 说明 |\n|---------|------|\n| 多协议支持 | 同时支持 stdio、SSE 和 Streamable HTTP 等多种传输协议 |\n| 环境适配 | 针对不同运行环境（本地、容器化、远程）提供最优传输方案 |\n| 协议演进 | 从已弃用的 HTTP+SSE 过渡到标准化的 Streamable HTTP |\n| 标准化接口 | 所有传输层实现遵循统一的 MCP 协议规范 |\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n## 传输层架构\n\nMCP 服务器的传输层采用模块化设计，每种传输协议都有独立的实现模块。项目结构如下：\n\n```\nsrc/everything/\n├── transports/\n│ ├── stdio.ts # 标准输入/输出传输\n│ ├── sse.ts # Server-Sent Events 传输\n│ └── streamableHttp.ts # 流式 HTTP 传输\n├── server/\n│ └── index.ts # 服务器工厂，注册所有传输层\n└── package.json\n```\n\n> 资料来源：[src/everything/transports/stdio.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/stdio.ts)\n\n### 传输层选择决策流程\n\n```mermaid\ngraph TD\n A[开始] --> B{运行环境}\n B -->|本地 Claude Desktop| C[Stdio 传输]\n B -->|Web/浏览器环境| D{SSE vs Streamable HTTP}\n B -->|VS Code / Zed| E{协议版本}\n D -->|旧版协议| F[SSE 传输]\n D -->|2025-03-26 后| G[Streamable HTTP]\n E -->|2025-03-26 前| F\n E -->|2025-03-26 后| H[Streamable HTTP]\n C --> I[进程间通信]\n F --> J[HTTP 长连接]\n G --> K[流式 HTTP 请求/响应]\n H --> K\n```\n\n## Stdio 传输\n\n### 工作原理\n\nStdio（标准输入/输出）是 MCP 服务器的默认传输方式，特别适用于本地进程间通信。当 MCP 客户端在本地启动服务器进程时，通过标准输入读取客户端请求，向标准输出写入服务端响应。\n\n```mermaid\nsequenceDiagram\n participant C as MCP 客户端\n participant S as MCP 服务器进程\n \n Note over C,S: 进程启动\n C->>S: 启动子进程，stdin/stdout 绑定\n C->>S: JSON-RPC 请求 (stdin)\n S->>S: 处理请求\n S->>C: JSON-RPC 响应 (stdout)\n C->>S: 下一个请求 (stdin)\n S->>C: 响应 (stdout)\n```\n\n### 启动命令\n\nStdio 传输是默认模式，无需显式指定：\n\n```bash\n# 默认使用 stdio\nnpx @modelcontextprotocol/server-everything\n\n# 显式指定 stdio\nnpx @modelcontextprotocol/server-everything stdio\n```\n\n### 配置示例\n\n**Claude Desktop 配置：**\n\n```json\n{\n \"mcpServers\": {\n \"everything\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@modelcontextprotocol/server-everything\"]\n }\n }\n}\n```\n\n**Windows 系统配置：**\n\n```json\n{\n \"mcpServers\": {\n \"everything\": {\n \"command\": \"cmd\",\n \"args\": [\"/c\", \"npx\", \"-y\", \"@modelcontextprotocol/server-everything\"]\n }\n }\n}\n```\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n## SSE 传输\n\n### 协议说明\n\nServer-Sent Events (SSE) 是一种基于 HTTP 的单向通信协议，允许服务器主动向客户端推送数据。SSE 传输在 MCP 协议早期版本中被广泛使用。\n\n### 状态说明\n\n| 状态 | 说明 |\n|-----|------|\n| 弃用日期 | 2025-03-26 |\n| 当前状态 | 已弃用，不建议新项目使用 |\n| 替代方案 | Streamable HTTP |\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n### 启动命令\n\n```bash\ncd src/everything\nnpm install\nnpm run start:sse\n```\n\n### 配置示例\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"]\n }\n }\n}\n```\n\n> 资料来源：[src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n\n## Streamable HTTP 传输\n\n### 协议说明\n\nStreamable HTTP 是 MCP 协议的当前标准传输方式，于 2025-03-26 正式成为规范定义的传输层。它支持请求/响应流式传输，提供了比 SSE 更灵活的双向通信能力。\n\n### 工作原理\n\n```mermaid\ngraph LR\n A[HTTP 客户端] -->|1. 建立连接| B[Streamable HTTP 服务器]\n A -->|2. 发送请求流| B\n B -->|3. 返回响应流| A\n A -->|4. 后续请求| B\n B -->|5. 持续响应| A\n```\n\n### 启动命令\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n### 作为独立包运行\n\n```bash\n# 使用 npx 运行\nnpx @modelcontextprotocol/server-everything streamableHttp\n\n# 全局安装后运行\nnpm install -g @modelcontextprotocol/server-everything@latest\n```\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n## 传输层配置对比\n\n### 各传输方式特性对比\n\n| 特性 | Stdio | SSE | Streamable HTTP |\n|------|-------|-----|-----------------|\n| 通信方向 | 双向 | 单向（服务端推送） | 双向流式 |\n| 连接类型 | 进程管道 | HTTP 长连接 | HTTP 流式 |\n| 适用场景 | 本地进程 | Web 推送 | Web 应用 |\n| 延迟 | 极低 | 低 | 低至中 |\n| 防火墙友好 | 否 | 是 | 是 |\n| 标准化程度 | MCP 默认 | 已弃用 | MCP 标准 |\n| 状态 | 活跃 | 弃用 | 活跃 |\n\n> 资料来源：[src/everything/transports/streamableHttp.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/streamableHttp.ts)\n\n### 运行时环境配置\n\n#### Docker 环境\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"--mount\", \"type=bind,src=${workspaceFolder},dst=/projects/workspace\",\n \"mcp/filesystem\",\n \"/projects\"\n ]\n }\n }\n}\n```\n\n> 资料来源：[src/filesystem/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)\n\n#### uvx 环境（Python 服务器）\n\n```json\n{\n \"mcpServers\": {\n \"time\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-time\"]\n }\n }\n}\n```\n\n> 资料来源：[src/time/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md)\n\n## 工具注册与传输层集成\n\n### 服务器启动流程\n\nMCP 服务器在启动时通过服务器工厂注册传输层。以下是工具注册的典型模式：\n\n```typescript\nserver.registerTool(\n \"write_file\",\n {\n title: \"Write File\",\n description: \"创建新文件或完全覆盖现有文件\",\n inputSchema: { path: z.string(), content: z.string() },\n outputSchema: { content: z.string() },\n annotations: { \n readOnlyHint: false, \n idempotentHint: true, \n destructiveHint: true \n }\n },\n async (args) => {\n // 处理请求逻辑\n }\n);\n```\n\n> 资料来源：[src/filesystem/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/index.ts)\n\n### 资源引用工具示例\n\n```typescript\nexport const registerGetResourceReferenceTool = (server: McpServer) => {\n server.registerTool(name, config, async (args): Promise => {\n // 验证资源类型\n const { resourceType } = args;\n if (!RESOURCE_TYPES.includes(resourceType)) {\n throw new Error(`Invalid resourceType...`);\n }\n \n // 验证资源ID\n const resourceId = Number(args?.resourceId);\n if (!Number.isFinite(resourceId) || resourceId < 1) {\n throw new Error(`Invalid resourceId...`);\n }\n \n // 根据类型获取资源\n const uri = resourceType === RESOURCE_TYPE_TEXT \n ? textResourceUri(resourceId) \n : blobResourceUri(resourceId);\n \n return { content: [...] };\n });\n};\n```\n\n> 资料来源：[src/everything/tools/get-resource-reference.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-resource-reference.ts)\n\n## 调试与测试\n\n### MCP Inspector 使用\n\nMCP Inspector 是官方提供的调试工具，支持所有传输层协议：\n\n```bash\n# 调试 stdio 服务器\nnpx @modelcontextprotocol/inspector uv run mcp-server-time\n\n# 调试 uvx 安装的服务器\nnpx @modelcontextprotocol/inspector uvx mcp-server-fetch\n\n# 调试本地开发服务器\ncd path/to/servers/src/fetch\nnpx @modelcontextprotocol/inspector uv run mcp-server-fetch\n```\n\n> 资料来源：[src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n\n## 最佳实践\n\n### 传输层选择指南\n\n| 场景 | 推荐传输层 |\n|-----|----------|\n| Claude Desktop 本地集成 | Stdio |\n| VS Code / Zed 编辑器 | Stdio 或 Streamable HTTP |\n| Web 应用前端 | Streamable HTTP |\n| 微服务架构 | Streamable HTTP |\n| 遗留系统维护 | SSE（临时）→ Streamable HTTP（迁移） |\n\n### 性能考虑\n\n- **Stdio**：适用于低延迟要求的本地场景，进程启动开销约 50-100ms\n- **Streamable HTTP**：适合需要横向扩展的服务端部署，支持连接复用\n- **SSE**：已弃用，仅用于兼容旧版客户端\n\n> 资料来源：[src/everything/transports/sse.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/sse.ts)\n\n## 技术规格\n\n### 项目技术栈\n\n| 组件 | 规格 |\n|-----|------|\n| TypeScript 目标 | ES2022 |\n| 模块系统 | Node16 |\n| 类型检查 | 严格模式 |\n| Node 版本 | 22+ |\n| 测试框架 | Vitest + @vitest/coverage-v8 |\n\n> 资料来源：[CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n\n## 扩展传输层\n\n### 添加新的传输实现\n\n根据 [AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md) 中的指导，扩展传输层的步骤如下：\n\n1. 在 `src/everything/transports/` 目录下创建新的传输模块文件\n2. 实现标准化的传输接口\n3. 在服务器工厂中注册新传输\n4. 更新 `package.json` 添加对应的 npm scripts\n\n### 命名规范\n\n- 文件命名：kebab-case（例：`custom-transport.ts`）\n- 导出函数：`registerXxxTransport(server)`\n- 内部类型：PascalCase\n\n> 资料来源：[src/everything/AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md)\n\n---\n\n\n\n## Filesystem 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Memory 服务器](#page-6), [Sequential Thinking 服务器](#page-7)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/filesystem/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/index.ts)\n- [src/filesystem/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/package.json)\n- [src/filesystem/path-validation.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/path-validation.ts)\n- [src/filesystem/roots-utils.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/roots-utils.ts)\n- [src/filesystem/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)\n \n\n# Filesystem 服务器\n\n## 概述\n\nFilesystem 服务器是 Model Context Protocol (MCP) 生态系统中专门用于文件系统操作的 MCP 服务器实现。该服务器为 AI 模型提供了一套完整的文件系统交互工具，使其能够在受控和安全的沙箱环境中读取、写入、搜索和管理本地文件系统中的文件和目录。资料来源：[src/filesystem/README.md]()\n\n## 核心功能\n\nFilesystem 服务器的核心职责是为 AI 助手提供文件系统访问能力，同时通过路径验证和沙箱机制确保操作的安全性。该服务器遵循 MCP 协议规范，支持通过 stdio、Streamable HTTP 和 SSE 等多种传输协议进行通信。资料来源：[src/filesystem/index.ts:1-50]()\n\n## 架构设计\n\n### 整体架构\n\n```mermaid\ngraph TD\n A[AI 模型] -->|MCP 协议| B[Filesystem 服务器]\n B -->|stdin/stdout| A\n B -->|路径验证| C[沙箱目录]\n B -->|Roots API| D[配置的根目录]\n C -->|文件操作| E[本地文件系统]\n \n F[read_text_file] -->|纯读取| C\n G[read_media_file] -->|纯读取| C\n H[write_file] -->|写入操作| C\n I[edit_file] -->|编辑操作| C\n J[move_file] -->|移动操作| C\n K[create_directory] -->|创建操作| C\n```\n\n### 工具分类\n\nFilesystem 服务器将所有工具按功能特性进行标注，每个工具都包含 `readOnlyHint`、`idempotentHint` 和 `destructiveHint` 三个关键注解，用于指示工具的行为特性。资料来源：[src/filesystem/README.md]()\n\n## 工具 API\n\n### 读取类工具\n\n| 工具名称 | 读取操作 | 幂等操作 | 破坏性操作 | 说明 |\n|---------|---------|---------|-----------|------|\n| `read_text_file` | ✓ | - | - | 纯文本读取 |\n| `read_media_file` | ✓ | - | - | 纯读取 |\n| `read_multiple_files` | ✓ | - | - | 纯读取 |\n| `list_directory` | ✓ | - | - | 纯读取 |\n| `list_directory_with_sizes` | ✓ | - | - | 纯读取 |\n| `directory_tree` | ✓ | - | - | 纯读取 |\n| `search_files` | ✓ | - | - | 纯读取 |\n| `get_file_info` | ✓ | - | - | 纯读取 |\n| `list_allowed_directories` | ✓ | - | - | 纯读取 |\n\n### 写入类工具\n\n| 工具名称 | 读取操作 | 幂等操作 | 破坏性操作 | 说明 |\n|---------|---------|---------|-----------|------|\n| `create_directory` | ✗ | ✓ | ✗ | 重建相同目录为空操作 |\n| `write_file` | ✗ | ✓ | ✓ | 覆盖现有文件 |\n| `edit_file` | ✗ | ✗ | ✓ | 重新应用编辑可能失败或重复应用 |\n| `move_file` | ✗ | ✗ | ✓ | 删除源文件 |\n\n> 注意：根据 MCP 协议规范，`idempotentHint` 和 `destructiveHint` 仅在 `readOnlyHint` 为 `false` 时才有意义。资料来源：[src/filesystem/README.md]()\n\n### read_text_file\n\n读取文件的完整文本内容作为纯文本返回。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `path` | string | 是 | 文件路径 |\n| `head` | number | 否 | 返回前 N 行 |\n| `tail` | number | 否 | 返回最后 N 行 |\n\n**使用限制：**\n\n- 不能同时指定 `head` 和 `tail`\n- 无论文件扩展名如何，始终将文件视为 UTF-8 文本处理\n- 仅在允许的目录范围内工作\n\n资料来源：[src/filesystem/README.md]()\n\n### read_media_file\n\n读取图像或音频文件，以 base64 编码的数据和对应的 MIME 类型返回。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `path` | string | 是 | 文件路径 |\n\n**返回格式：**\n\n```json\n{\n \"mimeType\": \"image/png\",\n \"data\": \"\"\n}\n```\n\n### read_multiple_files\n\n同时读取多个文件内容。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `paths` | string[] | 是 | 文件路径数组 |\n\n**特性：** 单个文件读取失败不会中断整个操作，失败的读取会返回错误信息。资料来源：[src/filesystem/index.ts]()\n\n### write_file\n\n创建新文件或完全覆盖现有文件内容。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `path` | string | 是 | 文件路径 |\n| `content` | string | 是 | 文件内容 |\n\n**安全提示：** 此操作会覆盖现有文件，使用时需谨慎。资料来源：[src/filesystem/index.ts]()\n\n### edit_file\n\n使用高级模式匹配和格式化进行选择性编辑。\n\n**支持的功能：**\n\n- 基于行和多行内容匹配\n- 保留缩进格式的空白符规范化\n- 多个同时编辑，位置计算正确\n- 缩进风格自动检测和保留\n- 带上下文的 Git 风格 diff 输出\n- 预览更改的干运行模式\n\n**输入参数：**\n\n```typescript\n{\n path: string; // 要编辑的文件路径\n edits: Array<{\n oldText: string; // 要搜索的文本（可以是子字符串）\n newText: string; // 替换的新文本\n }>;\n}\n```\n\n资料来源：[src/filesystem/README.md]()\n\n### 目录管理工具\n\n| 工具名称 | 功能描述 |\n|---------|---------|\n| `create_directory` | 创建新目录 |\n| `list_directory` | 列出目录内容 |\n| `list_directory_with_sizes` | 列出目录内容及文件大小 |\n| `directory_tree` | 显示目录树结构 |\n| `move_file` | 移动或重命名文件/目录 |\n\n### 搜索与信息工具\n\n| 工具名称 | 功能描述 |\n|---------|---------|\n| `search_files` | 在目录中搜索文件 |\n| `get_file_info` | 获取文件元数据信息 |\n| `list_allowed_directories` | 列出允许访问的目录 |\n\n## 安全机制\n\n### 路径验证\n\nFilesystem 服务器实现了严格的路径验证机制，确保所有文件操作都在配置的沙箱目录范围内进行。路径验证模块 (`path-validation.ts`) 负责检查每个文件路径是否在允许访问的目录树内。资料来源：[src/filesystem/path-validation.ts]()\n\n### 根目录 (Roots)\n\n服务器使用 MCP 的 Roots 机制来定义允许访问的目录范围。通过 `roots-utils.ts` 模块，服务器可以动态获取和验证允许的根目录列表。资料来源：[src/filesystem/roots-utils.ts]()\n\n### 操作注解\n\n服务器为每个工具提供标准化的注解，帮助 AI 模型理解工具行为的潜在影响：\n\n```mermaid\ngraph LR\n A[工具执行] --> B{readOnlyHint}\n B -->|true| C[安全执行]\n B -->|false| D{检查幂等性}\n D -->|idempotentHint| E[可安全重复执行]\n D -->|destructiveHint| F[可能产生破坏性后果]\n```\n\n## 安装与配置\n\n### Claude Desktop 配置\n\n#### Docker 安装\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"--mount\", \"type=bind,src=/Users/username/Desktop,dst=/projects/Desktop\",\n \"--mount\", \"type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro\",\n \"mcp/filesystem\",\n \"/projects\"\n ]\n }\n }\n}\n```\n\n> 注意：所有目录必须挂载到容器的 `/projects` 路径。添加 `ro` 标志会使目录对服务器只读。资料来源：[src/filesystem/README.md]()\n\n#### NPX 安装\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@modelcontextprotocol/server-filesystem\",\n \"/Users/username/Desktop\",\n \"/path/to/other/allowed/dir\"\n ]\n }\n }\n}\n```\n\n#### Windows 配置\n\n在 Windows 上，使用 `cmd /c` 启动 npx：\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"cmd\",\n \"args\": [\n \"/c\",\n \"npx\",\n \"-y\",\n \"@modelcontextprotocol/server-filesystem\",\n \"${workspaceFolder}\"\n ]\n }\n }\n}\n```\n\n### VS Code 配置\n\n通过一键安装按钮快速配置：\n\n[](https://insiders.vscode.dev/redirect/mcp/install?name=filesystem&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-filesystem%22%2C%22%24%7BworkspaceFolder%7D%22%5D%7D)\n\n### Docker 构建\n\n手动构建 Docker 镜像：\n\n```bash\ndocker build -t mcp/filesystem -f src/filesystem/Dockerfile .\n```\n\n## 项目结构\n\n```\nsrc/filesystem/\n├── index.ts # 主入口文件，定义所有工具\n├── path-validation.ts # 路径验证模块\n├── roots-utils.ts # 根目录工具模块\n├── package.json # NPM 包配置\n├── tsconfig.json # TypeScript 配置\n└── Dockerfile # Docker 镜像配置\n```\n\n### package.json 主要配置\n\n```json\n{\n \"name\": \"@modelcontextprotocol/server-filesystem\",\n \"version\": \"最新版本\",\n \"type\": \"module\",\n \"description\": \"MCP 服务器，提供文件系统访问能力\"\n}\n```\n\n资料来源：[src/filesystem/package.json]()\n\n## 开发指南\n\n### 运行环境\n\n- **Node.js 版本：** Node 22\n- **TypeScript 目标：** ES2022\n- **模块系统：** Node16\n- **测试框架：** Vitest\n- **类型检查：** TypeScript strict 模式\n\n### 代码规范\n\n- 使用 ES modules，导入路径带 `.js` 扩展名\n- 所有函数和变量使用严格的 TypeScript 类型\n- 使用 Zod schema 进行工具输入验证\n- 2 空格缩进，多行对象使用尾随逗号\n- 变量/函数使用 camelCase\n- 类型/类使用 PascalCase\n- 常量使用 UPPER_CASE\n- 文件名和注册工具使用 kebab-case\n- 工具名称使用动词优先（如 `get-file-info`）资料来源：[CLAUDE.md]()\n\n### 运行测试\n\n```bash\nnpm install\nnpm test\n```\n\n## 许可证\n\nFilesystem 服务器采用 MIT 许可证开源，允许自由使用、修改和分发软件。资料来源：[src/filesystem/README.md]()\n\n---\n\n\n\n## Memory 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Filesystem 服务器](#page-5), [Sequential Thinking 服务器](#page-7)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/memory/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/index.ts)\n- [src/memory/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/package.json)\n- [src/memory/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/README.md)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n- [src/everything/resources/session.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/resources/session.ts)\n- [src/everything/tools/get-resource-reference.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-resource-reference.ts)\n \n\n# Memory 服务器\n\n## 概述\n\nMemory 服务器是 Model Context Protocol (MCP) 生态系统中专注于知识图谱与记忆管理的 MCP 服务器实现。该服务器通过知识图谱结构为 AI 助手提供持久化记忆能力，使模型能够在多轮对话中保持上下文一致性，并主动管理用户信息、行为模式和偏好设置。\n\n核心特性包括：\n\n- 基于知识图谱的实体与关系存储\n- JSONL 格式的持久化存储\n- 支持记忆的创建、检索与更新操作\n- 与 Claude 等 MCP 客户端无缝集成\n\n资料来源：[src/memory/package.json:3-4]()\n\n## 核心功能\n\n### 知识图谱管理\n\nMemory 服务器采用实体-关系模型组织信息，支持以下核心实体类型：\n\n| 实体类型 | 描述 | 关系示例 |\n|---------|------|---------|\n| 用户身份 | 基本身份信息（年龄、性别、位置、职位等） | `has_identity` |\n| 行为数据 | 兴趣、习惯等行为信息 | `has_behavior` |\n| 偏好设置 | 沟通风格、首选语言等 | `has_preference` |\n| 目标规划 | 目标、期望、 aspirations | `has_goal` |\n| 关系网络 | 个人与职业关系（最多3度分离） | `knows`, `works_with` |\n\n### 记忆操作流程\n\n```mermaid\ngraph TD\n A[用户交互] --> B{是否识别用户}\n B -->|否| C[尝试识别用户]\n B -->|是| D[检索相关记忆]\n C --> D\n D --> E{发现新信息?}\n E -->|是| F[更新知识图谱]\n E -->|否| G[继续对话]\n F --> H[创建实体/关系]\n H --> G\n G --> I[响应用户]\n \n style F fill:#e1f5fe\n style H fill:#e1f5fe\n```\n\n资料来源：[src/memory/README.md:73-88]()\n\n## 系统架构\n\n### 组件架构图\n\n```mermaid\ngraph TD\n subgraph 客户端层\n A[Claude / MCP Client]\n end\n \n subgraph MCP 协议层\n B[Stdio Transport]\n C[HTTP + SSE Transport]\n end\n \n subgraph Memory 服务器\n D[知识图谱引擎]\n E[JSONL 存储适配器]\n F[实体管理器]\n G[关系管理器]\n end\n \n subgraph 存储层\n H[memory.jsonl]\n end\n \n A --> B\n A --> C\n B --> D\n C --> D\n D --> E\n E --> H\n D --> F\n D --> G\n F -.->|管理| H\n G -.->|管理| H\n```\n\n### 技术栈\n\n| 组件 | 技术选型 | 版本要求 |\n|------|---------|---------|\n| 运行时 | Node.js | 22+ |\n| 语言 | TypeScript | ES2022 |\n| SDK | @modelcontextprotocol/sdk | ^1.26.0 |\n| 包管理 | npm | - |\n| 测试框架 | vitest | ^2.1.8 |\n| 类型检查 | TypeScript | ^5.6.2 |\n\n资料来源：[src/memory/package.json:8-31]()\n\n## 安装与配置\n\n### 环境要求\n\n- Node.js 22 或更高版本\n- npm 或 yarn 包管理器\n\n### 安装方式\n\n#### NPX 方式\n\n适用于快速测试和临时使用场景：\n\n```json\n{\n \"mcpServers\": {\n \"memory\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@modelcontextprotocol/server-memory\"\n ],\n \"env\": {\n \"MEMORY_FILE_PATH\": \"/path/to/custom/memory.jsonl\"\n }\n }\n }\n}\n```\n\n资料来源：[src/memory/README.md:1-14]()\n\n#### Windows 配置\n\n在 Windows 系统上需要使用 `cmd` 作为入口：\n\n```json\n{\n \"mcpServers\": {\n \"memory\": {\n \"command\": \"cmd\",\n \"args\": [\n \"/c\",\n \"npx\",\n \"-y\",\n \"@modelcontextprotocol/server-memory\"\n ],\n \"env\": {\n \"MEMORY_FILE_PATH\": \"C:\\\\path\\\\to\\\\memory.jsonl\"\n }\n }\n }\n}\n```\n\n资料来源：[src/memory/README.md:17-32]()\n\n#### Docker 方式\n\n适用于生产环境和隔离部署：\n\n```json\n{\n \"mcpServers\": {\n \"memory\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-v\",\n \"claude-memory:/app/dist\",\n \"--rm\",\n \"mcp/memory\"\n ]\n }\n }\n}\n```\n\n### VS Code 快速安装\n\n支持一键安装按钮，可在 VS Code Insiders 中快速配置：\n\n```markdown\n[](https://insiders.vscode.dev/redirect/mcp/install?name=memory&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-memory%22%5D%7D)\n```\n\n资料来源：[src/memory/README.md:44-45]()\n\n## 配置选项\n\n### 环境变量\n\n| 变量名 | 类型 | 默认值 | 描述 |\n|--------|------|--------|------|\n| `MEMORY_FILE_PATH` | string | `memory.jsonl` (服务器目录内) | 记忆存储 JSONL 文件的路径 |\n\n### 配置文件结构\n\n```mermaid\ngraph LR\n A[memory.jsonl] --> B{记录格式}\n B --> C[JSONL 每行一个 JSON 对象]\n C --> D[实体定义]\n C --> E[关系定义]\n \n D --> D1[id]\n D --> D2[type]\n D --> D3[properties]\n \n E --> E1[source]\n E --> E2[target]\n E --> E3[relation_type]\n```\n\n#### JSONL 存储格式示例\n\n```jsonl\n{\"id\": \"entity_1\", \"type\": \"user\", \"properties\": {\"name\": \"张三\", \"job\": \"工程师\"}}\n{\"id\": \"entity_2\", \"type\": \"interest\", \"properties\": {\"category\": \"技术\", \"topics\": [\"AI\", \"区块链\"]}}\n{\"source\": \"entity_1\", \"target\": \"entity_2\", \"relation_type\": \"has_interest\"}\n```\n\n资料来源：[src/memory/README.md:14]()\n\n## 使用方法\n\n### 系统提示词配置\n\n为实现个性化聊天体验，建议在 Claude.ai Project 的\"自定义说明\"字段中添加以下提示词：\n\n```\nFollow these steps for each interaction:\n\n1. User Identification:\n - You should assume that you are interacting with default_user\n - If you have not identified default_user, proactively try to do so.\n\n2. Memory Retrieval:\n - Always begin your chat by saying only \"Remembering...\" and retrieve all relevant information from your knowledge graph\n - Always refer to your knowledge graph as your \"memory\"\n\n3. Memory\n - While conversing with the user, be attentive to any new information that falls into these categories:\n a) Basic Identity (age, gender, location, job title, education level, etc.)\n b) Behaviors (interests, habits, etc.)\n c) Preferences (communication style, preferred language, etc.)\n d) Goals (goals, targets, aspirations, etc.)\n e) Relationships (personal and professional relationships up to 3 degrees of separation)\n\n4. Memory Update:\n - If any new information was gathered during the interaction, update your memory as follows:\n a) Create entities for recurring organizations, people, and significant events\n b) Connect them to the current entities using relations\n```\n\n资料来源：[src/memory/README.md:73-94]()\n\n### 记忆检索流程\n\n```mermaid\nsequenceDiagram\n participant U as 用户\n participant C as Claude\n participant M as Memory 服务器\n participant KG as 知识图谱\n \n U->>C: 开始对话\n C->>M: 检索相关记忆\n M->>KG: 查询实体与关系\n KG-->>M: 返回记忆数据\n M-->>C: 格式化记忆\n C->>U: \"Remembering...\" + 相关记忆\n U->>C: 继续对话\n C->>M: 更新记忆（如有新信息）\n M->>KG: 创建/更新实体关系\n```\n\n### 记忆分类\n\n| 类别 | 内容 | 优先级 |\n|------|------|--------|\n| 基础身份 | 年龄、性别、位置、职位、学历等 | 高 |\n| 行为模式 | 兴趣、习惯等 | 中 |\n| 偏好设置 | 沟通风格、首选语言等 | 中 |\n| 目标规划 | 目标、期望、志向等 | 高 |\n| 关系网络 | 个人与职业关系（最多3度分离） | 中 |\n\n## 开发者指南\n\n### 本地开发\n\n#### 克隆与安装\n\n```bash\ngit clone https://github.com/modelcontextprotocol/servers.git\ncd servers/src/memory\nnpm install\n```\n\n#### 构建\n\n```bash\nnpm run build\n```\n\n构建产物输出至 `dist/` 目录，TypeScript 编译目标为 ES2022，模块系统为 Node16。\n\n资料来源：[CLAUDE.md:6-9]()\n\n#### 开发模式监视\n\n```bash\nnpm run watch\n```\n\n此命令启动 TypeScript 编译器监视模式，文件变更时自动重新编译。\n\n#### 测试\n\n```bash\nnpm run test\n```\n\n测试框架采用 vitest，支持覆盖率报告：\n\n```bash\nnpm test -- --coverage\n```\n\n### 代码规范\n\n#### TypeScript 规范\n\n- 使用 ES modules，导入路径带 `.js` 扩展名\n- 严格 TypeScript 类型检查\n- 使用 Zod schemas 进行工具输入验证\n- 2 空格缩进，多行对象保留尾随逗号\n- 变量/函数命名：camelCase\n- 类型/类命名：PascalCase\n- 常量命名：UPPER_CASE\n- 文件名：kebab-case\n\n资料来源：[CLAUDE.md:24-30]()\n\n### 项目结构\n\n```\nsrc/memory/\n├── index.ts # 主入口文件\n├── package.json # 项目配置\n├── tsconfig.json # TypeScript 配置\n├── dist/ # 编译输出目录\n└── test/ # 测试文件目录\n```\n\n## API 参考\n\n### MCP 工具接口\n\nMemory 服务器提供以下 MCP 协议接口：\n\n| 工具名称 | 输入参数 | 返回类型 | 描述 |\n|---------|---------|---------|------|\n| 记忆检索 | query | Memory[] | 根据查询条件检索记忆 |\n| 记忆创建 | entity, relations | Memory | 创建新实体和关系 |\n| 记忆更新 | id, updates | Memory | 更新现有实体 |\n| 记忆删除 | id | boolean | 删除指定实体及关联关系 |\n\n### 资源接口\n\n```typescript\ninterface Resource {\n uri: string; // 资源唯一标识符\n name: string; // 资源名称\n mimeType: string; // MIME 类型\n description?: string; // 资源描述\n annotations?: object; // 注解信息\n}\n```\n\n资料来源：[src/everything/resources/session.ts:1-9]()\n\n## 版本信息\n\n| 版本 | 发布日期 | 关键更新 |\n|------|---------|---------|\n| 0.6.3 | 当前版本 | 知识图谱优化、存储增强 |\n\n当前包版本信息存储于 `package.json` 的 `version` 字段：\n\n```json\n{\n \"name\": \"@modelcontextprotocol/server-memory\",\n \"version\": \"0.6.3\",\n \"description\": \"MCP server for enabling memory for Claude through a knowledge graph\"\n}\n```\n\n资料来源：[src/memory/package.json:2-4]()\n\n## 相关资源\n\n- [MCP 官方文档](https://modelcontextprotocol.io)\n- [MCP 协议规范](https://modelcontextprotocol.io/specification)\n- [Memory 服务器 Issues](https://github.com/modelcontextprotocol/servers/issues)\n- [MCP 服务器示例仓库](https://github.com/modelcontextprotocol/servers)\n\n---\n\n\n\n## Sequential Thinking 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Everything 服务器架构](#page-3), [Filesystem 服务器](#page-5)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/sequentialthinking/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/index.ts)\n- [src/sequentialthinking/lib.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/lib.ts)\n- [src/sequentialthinking/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/package.json)\n- [src/sequentialthinking/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/README.md)\n \n\n# Sequential Thinking 服务器\n\n## 概述\n\nSequential Thinking 服务器是 Model Context Protocol (MCP) 生态系统中的一款 MCP 服务器，专门提供顺序推理（Sequential Thinking）能力。该服务器允许 AI 模型执行链式思维推理过程，通过结构化的思考步骤来分解和解决复杂问题。\n\n该服务器的核心价值在于为 AI 助手提供一种可控、可追溯的推理框架，使模型能够在处理多步骤问题时保持逻辑连贯性，并能够回溯和修正推理路径。\n\n## 核心功能\n\n### 链式思维推理\n\nSequential Thinking 服务器提供了一套完整的链式思维推理工具集，使 AI 模型能够：\n\n- 将复杂问题分解为多个可管理的推理步骤\n- 沿着逻辑链路逐步推进思考过程\n- 在每个步骤中记录中间结果和推理依据\n- 支持条件分支和回溯操作\n\n### 思考日志管理\n\n服务器内置思考日志功能，可记录整个推理过程的详细信息。通过环境变量 `DISABLE_THOUGHT_LOGGING` 可以控制是否记录思考日志：\n\n```bash\n# 禁用思考日志记录\nexport DISABLE_THOUGHT_LOGGING=true\n```\n\n```json\n// 在 JSON 配置中设置\n{\n \"env\": {\n \"DISABLE_THOUGHT_LOGGING\": \"true\"\n }\n}\n```\n\n## 架构设计\n\n### 系统架构图\n\n```mermaid\ngraph TD\n A[客户端/AI模型] --> B[Sequential Thinking 服务器]\n B --> C[推理引擎]\n C --> D[状态管理器]\n D --> E[日志系统]\n C --> F[工具集]\n \n F --> F1[分解问题工具]\n F --> F2[推理步骤工具]\n F --> F3[回溯工具]\n F --> F4[总结工具]\n \n E -->|可选| G[外部日志服务]\n```\n\n### 组件关系\n\n| 组件 | 职责 | 数据流向 |\n|------|------|----------|\n| 推理引擎 | 处理链式思维逻辑 | 接收输入 → 执行推理 → 输出结果 |\n| 状态管理器 | 维护推理上下文状态 | 存储当前状态 → 支持回溯 |\n| 日志系统 | 记录推理过程 | 捕获步骤 → 格式化日志 |\n| 工具集 | 提供可调用接口 | 暴露给 MCP 客户端 |\n\n## 安装与配置\n\n### 环境要求\n\n- Node.js 环境（推荐 Node 22+）\n- Docker（可选，用于容器化部署）\n\n### 安装方式\n\n#### 方式一：NPX 远程执行\n\n**macOS/Linux 配置：**\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@modelcontextprotocol/server-sequential-thinking\"\n ]\n }\n }\n}\n```\n\n**Windows 配置：**\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"cmd\",\n \"args\": [\n \"/c\",\n \"npx\",\n \"-y\",\n \"@modelcontextprotocol/server-sequential-thinking\"\n ]\n }\n }\n}\n```\n\n#### 方式二：Docker 容器部署\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"mcp/sequentialthinking\"\n ]\n }\n }\n}\n```\n\n**Docker 构建命令：**\n\n```bash\ndocker build -t mcp/sequentialthinking -f src/sequentialthinking/Dockerfile .\n```\n\n### Claude Desktop 配置\n\n在 `claude_desktop_config.json` 中添加以下配置：\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@modelcontextprotocol/server-sequential-thinking\"]\n }\n }\n}\n```\n\n### VS Code 配置\n\n支持一键安装，可通过 VS Code 安装按钮直接添加：\n\n- [Install with NPX in VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=sequentialthinking&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-sequential-thinking%22%5D%7D)\n- [Install with NPX in VS Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=sequentialthinking&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-sequential-thinking%22%5D%7D&quality=insiders)\n\n## 使用方法\n\n### 与 Codex CLI 集成\n\n使用 npx 运行 Sequential Thinking 服务器：\n\n```bash\ncodex mcp add sequential-thinking npx -y @modelcontextprotocol/server-sequential-thinking\n```\n\n### 典型工作流程\n\n```mermaid\ngraph LR\n A[输入复杂问题] --> B[分解为子问题]\n B --> C[执行第一步推理]\n C --> D{是否完成?}\n D -->|否| E[记录中间结果]\n E --> F[执行下一步推理]\n F --> D\n D -->|是| G[生成最终答案]\n```\n\n## 工具接口\n\n### 可用工具\n\n| 工具名称 | 功能描述 | 使用场景 |\n|----------|----------|----------|\n| `sequentialthinking` | 主推理工具 | 执行链式思维推理 |\n| `log_thought` | 记录思考步骤 | 追踪推理过程 |\n| `reset_thinking` | 重置推理状态 | 开始新的推理链 |\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 说明 |\n|--------|------|------|------|\n| `query` | string | 是 | 需要推理的问题或任务 |\n| `context` | object | 否 | 额外的上下文信息 |\n| `maxSteps` | number | 否 | 最大推理步骤数 |\n\n### 输出格式\n\n```json\n{\n \"thought\": \"推理思考内容\",\n \"nextStep\": \"下一步推理方向\",\n \"conclusion\": \"阶段性结论\",\n \"metadata\": {\n \"stepNumber\": 1,\n \"totalSteps\": 5\n }\n}\n```\n\n## 环境变量配置\n\n| 变量名 | 默认值 | 说明 |\n|--------|--------|------|\n| `DISABLE_THOUGHT_LOGGING` | `false` | 设置为 `true` 可禁用思考日志 |\n\n## 调试与故障排查\n\n### MCP Inspector 调试\n\n使用 MCP Inspector 可以对服务器进行调试：\n\n```bash\nnpx @modelcontextprotocol/inspector npx -y @modelcontextprotocol/server-sequential-thinking\n```\n\n### 常见问题\n\n**问题：服务器启动超时**\n\n解决方案：确保 Node.js 版本符合要求（Node 22+），并检查网络连接。\n\n**问题：日志记录过多**\n\n解决方案：设置 `DISABLE_THOUGHT_LOGGING=true` 环境变量。\n\n## 许可证\n\nSequential Thinking 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。\n\n资料来源：[src/sequentialthinking/README.md:66-68]()\n\n## 相关资源\n\n- MCP 官方规范：https://modelcontextprotocol.io/specification\n- 服务器源码仓库：https://github.com/modelcontextprotocol/servers\n- 官方文档：https://modelcontextprotocol.io\n\n---\n\n\n\n## Everything 服务器扩展指南\n\n### 相关页面\n\n相关主题：[Everything 服务器架构](#page-3)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/everything/AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md)\n- [src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n- [src/everything/resources/session.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/resources/session.ts)\n- [src/everything/tools/get-roots-list.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-roots-list.ts)\n \n\n# Everything 服务器扩展指南\n\n## 概述\n\nEverything 服务器是 Model Context Protocol (MCP) 生态系统中功能最全面的服务器实现之一，采用 TypeScript 开发，专门设计用于展示 MCP 协议的各项特性。服务器提供工具（Tools）、资源（Resources）和提示（Prompts）三大核心功能模块。\n\n本扩展指南将帮助开发者理解如何在 Everything 服务器中添加新功能、注册工具和资源，以及遵循项目既定的代码规范进行开发。\n\n## 架构设计\n\n### 高层架构\n\nEverything 服务器采用模块化架构设计，核心服务器工厂位于 `src/everything/server/index.ts`，负责在启动时注册所有功能模块并处理连接后的设置。\n\n```\ngraph TD\n A[Server Factory
server/index.ts] --> B[Tools 模块]\n A --> C[Resources 模块]\n A --> D[Prompts 模块]\n A --> E[Transports 模块]\n B --> B1[registerTools]\n C --> C1[registerResources]\n D --> D1[registerPrompts]\n E --> E1[HTTP+SSE Transport]\n E --> E2[Streamable HTTP Transport]\n```\n\n资料来源：[src/everything/AGENTS.md:52-53]()\n\n### 功能模块布局\n\n| 模块 | 路径 | 注册函数 |\n|------|------|----------|\n| 工具 | `src/everything/tools/` | `registerTools(server)` |\n| 资源 | `src/everything/resources/` | `registerResources(server)` |\n| 提示 | `src/everything/prompts/` | `registerPrompts(server)` |\n| 订阅与模拟更新 | `src/everything/resources/subscriptions.ts` | - |\n| 日志辅助 | `src/everything/server/logging.ts` | - |\n| 传输管理 | `src/everything/transports/` | - |\n\n资料来源：[src/everything/AGENTS.md:35-41]()\n\n## 代码风格规范\n\n### 命名约定\n\nEverything 服务器遵循统一的命名规范，确保代码库的一致性和可维护性：\n\n| 类型 | 规范 | 示例 |\n|------|------|------|\n| 变量/函数 | camelCase | `getFileInfo`, `currentRoots` |\n| 类型/类 | PascalCase | `McpServer`, `Resource` |\n| 常量 | UPPER_CASE | `DEFAULT_TIMEOUT` |\n| 文件名及注册项 | kebab-case | `get-annotated-message.ts`, `get-file-info` |\n| 工具名称 | 动词优先 | `get-file-info`（而非 `file-info`） |\n\n资料来源：[src/everything/AGENTS.md:19-23]()\n\n### 文件组织规则\n\n每个功能模块应遵循现有的文件/模块模式，包括：\n- 命名规范\n- 导出结构\n- 注册函数命名（`registerX` 格式）\n\n## 添加新功能\n\n### 扩展工具模块\n\n#### 步骤一：创建工具文件\n\n在 `src/everything/tools/` 目录下创建新的工具文件，使用 kebab-case 命名：\n\n```typescript\n// src/everything/tools/get-roots-list.ts\n\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\n\nexport const registerGetRootsListTool = (server: McpServer) => {\n // 实现工具逻辑\n};\n```\n\n#### 步骤二：导出注册函数\n\n每个工具模块需要导出 `registerX(server)` 函数，用于将新工具注册到 MCP SDK：\n\n```typescript\nexport const registerGetRootsListTool = (server: McpServer) => {\n server.setRequestHandler(\n ListToolsRequestSchema,\n async () => {\n return {\n tools: [\n {\n name: \"get-roots-list\",\n description: \"获取当前 MCP Roots 列表\",\n inputSchema: {\n type: \"object\",\n properties: {},\n },\n },\n ],\n };\n }\n );\n};\n```\n\n资料来源：[src/everything/tools/get-roots-list.ts:1-35]()\n\n#### 步骤三：更新索引文件\n\n将新工具集成到中央索引中，更新 `src/everything/tools/index.ts` 文件。\n\n### 扩展资源模块\n\n#### 资源注册流程\n\n资源模块的注册遵循类似的模式，位于 `src/everything/resources/` 目录：\n\n```typescript\n// 资源注册函数签名\nexport const registerSessionResource = (\n server: McpServer,\n resource: Resource,\n type: \"text\" | \"blob\",\n payload: string\n): ResourceLink => {\n // 1. 解构资源对象\n const { uri, name, mimeType, description, title, annotations, icons, _meta } = resource;\n \n // 2. 准备资源内容\n const resourceContent = type === \"text\" \n ? { uri: uri.toString(), mimeType, text: payload }\n : { uri: uri.toString(), mimeType, blob: payload };\n\n // 3. 检查并移除已存在的同名资源\n const existingResource = registeredResources.get(uri);\n if (existingResource) {\n existingResource.remove();\n registeredResources.delete(uri);\n }\n\n // 4. 注册新资源\n const registeredResource = server.registerResource(\n name,\n uri,\n { mimeType, description, title, annotations, icons, _meta },\n async () => ({\n contents: [resourceContent],\n })\n );\n\n // 5. 追踪已注册资源以便后续移除\n registeredResources.set(uri, registeredResource);\n\n return { type: \"resource_link\", ...resource };\n};\n```\n\n资料来源：[src/everything/resources/session.ts:25-63]()\n\n### 扩展提示模块\n\n提示（Prompts）模块位于 `src/everything/prompts/` 目录，遵循与工具和资源相同的注册模式：\n\n1. 在对应目录下创建新文件\n2. 导出 `registerPrompts(server)` 函数\n3. 更新中央索引 `src/everything/prompts/index.ts`\n\n### 更新中央索引\n\n添加新功能后，必须将新模块连接到中央索引：\n\n| 索引文件 | 需要更新的内容 |\n|----------|----------------|\n| `tools/index.ts` | 导入并注册新工具 |\n| `resources/index.ts` | 导入并注册新资源 |\n| `prompts/index.ts` | 导入并注册新提示 |\n\n资料来源：[src/everything/AGENTS.md:49-51]()\n\n## 工具输入验证\n\n### JSON Schema 要求\n\n所有工具的 inputSchema 必须符合准确的 JSON Schema 规范，并包含有用的描述和示例：\n\n```typescript\ninputSchema: {\n type: \"object\",\n properties: {\n url: {\n type: \"string\",\n description: \"要获取的 URL 地址\",\n examples: [\"https://example.com\"]\n },\n maxLength: {\n type: \"integer\",\n description: \"返回的最大字符数\",\n default: 5000,\n minimum: 1,\n maximum: 1000000\n }\n },\n required: [\"url\"]\n}\n```\n\n资料来源：[src/everything/AGENTS.md:51]()\n\n## 服务器工厂模式\n\n### 初始化流程\n\n`src/everything/server/index.ts` 是服务器的中央入口点，负责：\n\n```mermaid\nsequenceDiagram\n participant Start as 启动服务器\n participant Factory as Server Factory
server/index.ts\n participant Tools as Tools 模块\n participant Resources as Resources 模块\n participant Prompts as Prompts 模块\n \n Start->>Factory: 初始化 McpServer 实例\n Factory->>Tools: registerTools(server)\n Factory->>Resources: registerResources(server)\n Factory->>Prompts: registerPrompts(server)\n Factory->>Factory: 处理连接后设置\n```\n\n## 运行和测试\n\n### 开发模式运行\n\n#### 使用 Streamable HTTP Transport（推荐）\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n#### 使用 HTTP+SSE Transport（已弃用）\n\n```bash\ncd src/everything\nnpm install\nnpm run start:sse\n```\n\n#### 直接运行已安装包\n\n```bash\n# 全局安装\nnpm install -g @modelcontextprotocol/server-everything@latest\n\n# 运行 stdio 服务器\nnpx @modelcontextprotocol/server-everything\n\n# 运行 SSE 服务器\nnpx @modelcontextprotocol/server-everything sse\n\n# 运行 Streamable HTTP 服务器\nnpx @modelcontextprotocol/server-everything streamableHttp\n```\n\n资料来源：[src/everything/README.md:75-98]()\n\n## 项目配置要求\n\n### TypeScript 配置\n\n| 配置项 | 值 |\n|--------|-----|\n| 目标版本 | ES2022 |\n| 模块系统 | Node16 |\n| 模式 | 严格模式 |\n| 测试框架 | vitest + @vitest/coverage-v8 |\n| Node 版本 | 22 |\n\n### 依赖项分组\n\n导入语句应按以下顺序分组：\n\n1. 外部依赖\n2. 内部依赖\n\n```typescript\n// ✅ 正确的导入顺序\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { registerTools } from \"./tools/index.js\";\nimport { registerResources } from \"./resources/index.js\";\n```\n\n## 文档维护\n\n添加或修改重要功能后，必须更新以下文档：\n\n- `src/everything/docs/` 目录下的相关文档\n- `docs/extension.md` - 扩展指南\n- `docs/structure.md` - 项目结构文档\n- `docs/how-it-works.md` - 工作原理文档\n\n资料来源：[src/everything/AGENTS.md:53-54]()\n\n## 总结\n\nEverything 服务器的扩展遵循清晰的设计模式：\n\n1. **遵循命名规范** - camelCase、PascalCase、UPPER_CASE、kebab-case 各有其用\n2. **模块化组织** - 工具、资源、提示各有独立目录\n3. **统一注册函数** - 每个模块导出 `registerX(server)` 格式的注册函数\n4. **中央索引管理** - 通过 index.ts 文件统一管理模块导出\n5. **Schema 验证** - 工具输入必须使用准确的 JSON Schema 并包含描述和示例\n\n---\n\n\n\n## Fetch 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Git 服务器](#page-10)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/fetch/pyproject.toml](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/pyproject.toml)\n- [src/fetch/src/mcp_server_fetch/server.py](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/src/mcp_server_fetch/server.py)\n- [src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n- [src/filesystem/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)\n \n\n# Fetch 服务器\n\nFetch 服务器是 Model Context Protocol (MCP) 生态系统中专注于网页内容获取的服务器实现。它使大语言模型能够检索并处理网页内容，将 HTML 转换为 Markdown 格式，便于模型理解和分析。\n\n资料来源：[src/fetch/README.md:1-15]()\n\n## 核心功能概述\n\nFetch 服务器的核心能力体现在以下方面：\n\n- **网页内容获取**：根据提供的 URL 抓取网页原始内容\n- **HTML 转 Markdown**：自动将 HTML 内容转换为结构化的 Markdown 格式\n- **内容分块读取**：支持通过 `start_index` 参数实现内容的分段获取\n- **灵活配置**：支持自定义 User-Agent、robots.txt 策略和代理设置\n\n资料来源：[src/fetch/README.md:15-30]()\n\n## 架构设计\n\n### 系统组件\n\n```mermaid\ngraph TD\n A[用户/模型] --> B[Fetch 服务器]\n B --> C{请求类型判断}\n C -->|工具调用| D[Model User-Agent]\n C -->|用户提示| E[User-Specified User-Agent]\n D --> F[HTTP 请求]\n E --> F\n F --> G{响应内容类型}\n G -->|HTML| H[Markdown 转换]\n G -->|其他| I[原始内容返回]\n H --> J[内容截断/分页]\n I --> J\n J --> K[返回给调用方]\n```\n\n### 工作流程\n\nFetch 服务器的处理流程遵循以下步骤：\n\n1. 接收请求并解析 URL 和参数\n2. 根据请求来源（工具调用或用户提示）设置 User-Agent\n3. 发起 HTTP 请求获取网页内容\n4. 检测内容类型并执行相应处理\n5. 如为 HTML 且未强制返回原始内容，则转换为 Markdown\n6. 根据 `max_length` 和 `start_index` 进行内容截断\n7. 返回结果给调用方\n\n资料来源：[src/fetch/README.md:45-60]()\n\n## 工具接口\n\n### fetch 工具\n\nFetch 服务器提供单一工具 `fetch`，用于获取网页内容。\n\n资料来源：[src/fetch/README.md:30-45]()\n\n#### 输入参数\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `url` | string | 是 | - | 要获取的网页 URL |\n| `max_length` | integer | 否 | 5000 | 返回内容的最大字符数 |\n| `start_index` | integer | 否 | 0 | 内容提取的起始字符索引 |\n| `raw` | boolean | 否 | false | 是否返回原始 HTML 内容（不做 Markdown 转换） |\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:70-85]()\n\n#### 参数约束\n\n```python\nclass Fetch(BaseModel):\n \"\"\"Parameters for fetching a URL.\"\"\"\n\n url: Annotated[AnyUrl, Field(description=\"URL to fetch\")]\n max_length: Annotated[\n int,\n Field(\n default=5000,\n description=\"Maximum number of characters to return.\",\n gt=0,\n lt=1000000,\n ),\n ]\n start_index: Annotated[\n int,\n Field(\n default=0,\n description=\"On return output starting at this character index...\",\n ge=0,\n ),\n ]\n raw: Annotated[\n bool,\n Field(\n default=False,\n description=\"Get the actual HTML content of the requested page...\",\n ),\n ]\n```\n\n- `max_length` 必须大于 0 且小于 1000000\n- `start_index` 必须大于等于 0\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:30-55]()\n\n## 服务器配置\n\n### serve 函数参数\n\n```python\nasync def serve(\n custom_user_agent: str | None = None,\n ignore_robots_txt: bool = False,\n proxy_url: str | None = None,\n) -> None:\n \"\"\"Run the fetch MCP server.\n \n Args:\n custom_user_agent: Optional custom User-Agent string\n ignore_robots_txt: Whether to ignore robots.txt restrictions\n proxy_url: Optional proxy URL to use\n \"\"\"\n```\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:90-100]()\n\n### 配置选项总览\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `--user-agent` | string | ModelContextProtocol/1.0 | 自定义 User-Agent |\n| `--ignore-robots-txt` | flag | false | 是否忽略 robots.txt |\n| `--proxy-url` | string | null | 代理服务器地址 |\n\n资料来源：[src/fetch/README.md:60-75]()\n\n## User-Agent 策略\n\nFetch 服务器根据请求来源使用不同的 User-Agent：\n\n| 请求来源 | User-Agent | 说明 |\n|----------|------------|------|\n| 工具调用（通过 MCP 工具） | `ModelContextProtocol/1.0 (Autonomous; +https://github.com/modelcontextprotocol/servers)` | 标识为自主行为 |\n| 用户提示（用户直接请求） | `ModelContextProtocol/1.0 (User-Specified; +https://github.com/modelcontextprotocol/servers)` | 标识为用户指定 |\n\n此设计使目标网站能够区分自动化工具请求和用户直接访问请求。\n\n资料来源：[src/fetch/README.md:55-65]()\n\n## 内容处理逻辑\n\n### HTML 检测\n\n服务器通过以下方式判断响应是否为 HTML：\n\n```python\ncontent_type = response.headers.get(\"content-type\", \"\")\nis_page_html = (\n \" B{是否为 HTML?}\n B -->|是| C{force_raw 参数?}\n B -->|否| D[返回原始内容]\n C -->|是| D\n C -->|否| E[提取并转换为 Markdown]\n E --> F[添加说明前缀]\n D --> G[内容截断处理]\n F --> G\n G --> H[返回结果]\n```\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:25-35]()\n\n## 安装与部署\n\n### 安装方式对比\n\n| 安装方式 | 命令 | 适用场景 |\n|----------|------|----------|\n| uvx（推荐） | `uvx mcp-server-fetch` | 快速使用，无需安装 |\n| pip | `pip install mcp-server-fetch` | 持久化安装 |\n| Docker | `docker run -i --rm mcp/fetch` | 隔离环境 |\n\n资料来源：[src/fetch/README.md:70-90]()\n\n### Claude Desktop 配置\n\n\nuvx 配置
\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"]\n }\n }\n}\n```\n \n\n\nDocker 配置
\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"mcp/fetch\"]\n }\n }\n}\n```\n \n\n\npip 配置
\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_fetch\"]\n }\n }\n}\n```\n \n\n资料来源：[src/fetch/README.md:90-125]()\n\n### Windows 特殊配置\n\n在 Windows 系统上，建议设置 `PYTHONIOENCODING` 环境变量以避免字符编码问题导致的超时：\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"],\n \"env\": {\n \"PYTHONIOENCODING\": \"utf-8\"\n }\n }\n }\n}\n```\n\n资料来源：[src/fetch/README.md:40-50]()\n\n## 调试与开发\n\n### MCP Inspector\n\n使用 MCP Inspector 可以调试服务器：\n\n```bash\n# uvx 安装\nnpx @modelcontextprotocol/inspector uvx mcp-server-fetch\n\n# 源码调试\ncd path/to/servers/src/fetch\nnpx @modelcontextprotocol/inspector uv run mcp-server-fetch\n```\n\n资料来源：[src/fetch/README.md:55-65]()\n\n### 可选依赖\n\n安装 Node.js 后，Fetch 服务器会使用更强大的 HTML 简化库：\n\n> Optionally: Install node.js, this will cause the fetch server to use a different HTML simplifier that is more robust.\n\n资料来源：[src/fetch/README.md:70-75]()\n\n## 安全考量\n\n### 风险警告\n\n> [!CAUTION]\n> 此服务器可以访问本地/内部 IP 地址，可能存在安全风险。使用此 MCP 服务器时需谨慎，确保不会暴露敏感数据。\n\n资料来源：[src/fetch/README.md:15-20]()\n\n### 安全机制\n\n- **robots.txt 遵循**：默认遵守目标网站的 robots.txt 规则\n- **User-Agent 标识**：明确标识为自动化工具，便于网站识别和限制\n- **目录访问控制**：与 filesystem 服务器不同，fetch 服务器不限制访问路径\n\n资料来源：[src/fetch/README.md:20-30]()\n\n## 与其他 MCP 服务器的关系\n\nFetch 服务器是 MCP 服务器生态的一部分，与其他服务器的协作模式如下：\n\n```mermaid\ngraph LR\n A[文件系统服务器] -->|提供本地文件操作| B[Claude/模型]\n C[Fetch 服务器] -->|提供网络内容获取| B\n D[Memory 服务器] -->|提供持久化存储| B\n E[Time 服务器] -->|提供时间信息| B\n```\n\n资料来源：[src/filesystem/README.md:1-20]()\n\n## 项目规范\n\n根据项目规范，Fetch 服务器遵循以下标准：\n\n- **Python 版本**：>= 3.10\n- **类型检查**：pyright\n- **代码风格**：ruff\n- **包管理**：uv（使用 uv sync 和 uv run）\n- **测试框架**：pytest-asyncio（异步测试）\n\n资料来源：[CLAUDE.md:20-40]()\n\n## 贡献指南\n\n项目欢迎对 Fetch 服务器的贡献：\n\n- 错误修复\n- 可用性改进\n- MCP 协议特性演示（Resources、Prompts、Roots）\n\n贡献方式请参考项目根目录的 [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)。\n\n资料来源：[CLAUDE.md:45-55]()\n\n---\n\n\n\n## Git 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Fetch 服务器](#page-9)\n\n根据提供的上下文，我无法生成关于 Git 服务器的完整技术文档，因为所提供的内容中**不包含 Git 服务器的源码文件**。\n\n## 可用的源码文件\n\n在提供的上下文中，我仅找到以下源码文件：\n\n| 文件路径 | 说明 |\n|---------|------|\n| src/fetch/README.md | Fetch 服务器文档 |\n| src/sequentialthinking/README.md | 顺序思考服务器文档 |\n| src/time/README.md | 时间服务器文档 |\n| src/filesystem/README.md | 文件系统服务器文档 |\n| src/everything/README.md | Everything 服务器文档 |\n| README.md | 仓库主文档 |\n| CLAUDE.md | 开发者指南 |\n| scripts/release.py | 发布脚本 |\n| src/memory/README.md | 记忆服务器文档 |\n\n## 缺失的源码文件\n\n根据 WIKI_PAGE_TOPIC 请求的 \"Git 服务器\"，以下关键文件**不在提供的上下文中**：\n\n- `src/git/pyproject.toml`\n- `src/git/src/mcp_server_git/server.py`\n- `src/git/README.md`\n\n## 结论\n\n无法生成关于 Git 服务器的技术 wiki 页面，因为需要的关键源码文件在提供的上下文中不可用。需要您提供 Git 服务器相关的源码文件后才能生成准确且符合要求的技术文档。\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：modelcontextprotocol/servers\n\n摘要：发现 6 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：能力坑 - 能力判断依赖假设。\n\n## 1. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | README/documentation is current enough for a first validation pass.\n\n## 2. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | last_activity_observed missing\n\n## 3. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n\n## 4. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n\n## 5. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | issue_or_pr_quality=unknown\n\n## 6. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | release_recency=unknown\n\n\n",
"markdown_key": "servers",
"pages": "draft",
"source_refs": [
{
"evidence_id": "github_repo:890668799",
"kind": "repo",
"supports_claim_ids": [
"claim_identity",
"claim_distribution",
"claim_capability"
],
"url": "https://github.com/modelcontextprotocol/servers"
},
{
"evidence_id": "art_31a669ac5f81463883f2a87cec73c103",
"kind": "docs",
"supports_claim_ids": [
"claim_identity",
"claim_distribution",
"claim_capability"
],
"url": "https://github.com/modelcontextprotocol/servers#readme"
}
],
"summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
"title": "servers 说明书",
"toc": [
"https://github.com/modelcontextprotocol/servers 项目说明书",
"目录",
"项目简介",
"项目概述",
"核心功能",
"技术架构",
"支持的客户端",
"开发规范",
"Doramagic 踩坑日志"
]
}
},
"quality_gate": {
"blocking_gaps": [],
"category_confidence": "medium",
"compile_status": "ready_for_review",
"five_assets_present": true,
"install_sandbox_verified": true,
"missing_evidence": [],
"next_action": "publish to Doramagic.ai project surfaces",
"prompt_preview_boundary_ok": true,
"publish_status": "publishable",
"quick_start_verified": true,
"repo_clone_verified": true,
"repo_commit": "4503e2d12b799448cd05f789dd40f9643a8d1a6c",
"repo_inspection_error": null,
"repo_inspection_files": [
"package.json",
"README.md",
"src/time/pyproject.toml",
"src/time/README.md",
"src/memory/vitest.config.ts",
"src/memory/index.ts",
"src/memory/package.json",
"src/memory/README.md",
"src/memory/tsconfig.json",
"src/everything/AGENTS.md",
"src/everything/vitest.config.ts",
"src/everything/index.ts",
"src/everything/package.json",
"src/everything/README.md",
"src/everything/tsconfig.json",
"src/git/pyproject.toml",
"src/git/README.md",
"src/sequentialthinking/vitest.config.ts",
"src/sequentialthinking/index.ts",
"src/sequentialthinking/package.json",
"src/sequentialthinking/README.md",
"src/sequentialthinking/lib.ts",
"src/sequentialthinking/tsconfig.json",
"src/fetch/pyproject.toml",
"src/fetch/README.md",
"src/filesystem/vitest.config.ts",
"src/filesystem/index.ts",
"src/filesystem/path-validation.ts",
"src/filesystem/package.json",
"src/filesystem/README.md",
"src/filesystem/roots-utils.ts",
"src/filesystem/lib.ts",
"src/filesystem/tsconfig.json",
"src/filesystem/path-utils.ts",
"src/time/test/time_server_test.py",
"src/time/src/mcp_server_time/server.py",
"src/time/src/mcp_server_time/__init__.py",
"src/time/src/mcp_server_time/__main__.py",
"src/memory/__tests__/knowledge-graph.test.ts",
"src/memory/__tests__/file-path.test.ts"
],
"repo_inspection_verified": true,
"review_reasons": [],
"tag_count_ok": true,
"unsupported_claims": []
},
"schema_version": "0.1",
"user_assets": {
"ai_context_pack": {
"asset_id": "ai_context_pack",
"filename": "AI_CONTEXT_PACK.md",
"markdown": "# @modelcontextprotocol/servers - Doramagic AI Context Pack\n\n> 定位：安装前体验与判断资产。它帮助宿主 AI 有一个好的开始，但不代表已经安装、执行或验证目标项目。\n\n## 充分原则\n\n- **充分原则，不是压缩原则**：AI Context Pack 应该充分到让宿主 AI 在开工前理解项目价值、能力边界、使用入口、风险和证据来源；它可以分层组织，但不以最短摘要为目标。\n- **压缩策略**：只压缩噪声和重复内容，不压缩会影响判断和开工质量的上下文。\n\n## 给宿主 AI 的使用方式\n\n你正在读取 Doramagic 为 @modelcontextprotocol/servers 编译的 AI Context Pack。请把它当作开工前上下文：帮助用户理解适合谁、能做什么、如何开始、哪些必须安装后验证、风险在哪里。不要声称你已经安装、运行或执行了目标项目。\n\n## Claim 消费规则\n\n- **事实来源**：Repo Evidence + Claim/Evidence Graph；Human Wiki 只提供显著性、术语和叙事结构。\n- **事实最低状态**：`supported`\n- `supported`：可以作为项目事实使用，但回答中必须引用 claim_id 和证据路径。\n- `weak`：只能作为低置信度线索，必须要求用户继续核实。\n- `inferred`：只能用于风险提示或待确认问题，不能包装成项目事实。\n- `unverified`：不得作为事实使用，应明确说证据不足。\n- `contradicted`：必须展示冲突来源，不得替用户强行选择一个版本。\n\n## 它最适合谁\n\n- **正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**：README 或插件配置提到多个宿主 AI。 证据：`README.md` Claim：`clm_0002` supported 0.86\n\n## 它能做什么\n\n- **命令行启动或安装流程**（需要安装后验证）：项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 证据：`CLAUDE.md`, `README.md` Claim：`clm_0001` supported 0.86\n\n## 怎么开始\n\n- `npx -y @modelcontextprotocol/server-memory` 证据：`README.md` Claim：`clm_0003` supported 0.86\n- `pip install mcp-server-git` 证据：`README.md` Claim：`clm_0004` supported 0.86\n- `npm install && npm run build` 证据：`CLAUDE.md` Claim：`clm_0005` supported 0.86\n\n## 继续前判断卡\n\n- **当前建议**：需要管理员/安全审批\n- **为什么**：继续前可能涉及密钥、账号、外部服务或敏感上下文，建议先经过管理员或安全审批。\n\n### 30 秒判断\n\n- **现在怎么做**：需要管理员/安全审批\n- **最小安全下一步**：先跑 Prompt Preview；若涉及凭证或企业环境，先审批再试装\n- **先别相信**：角色质量和任务匹配不能直接相信。\n- **继续会触碰**：角色选择偏差、命令执行、宿主 AI 配置\n\n### 现在可以相信\n\n- **适合人群线索：正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`README.md` Claim：`clm_0002` supported 0.86\n- **能力存在：命令行启动或安装流程**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`CLAUDE.md`, `README.md` Claim：`clm_0001` supported 0.86\n- **存在 Quick Start / 安装命令线索**（supported）：可以相信项目文档出现过启动或安装入口；不要因此直接在主力环境运行。 证据：`README.md` Claim：`clm_0003` supported 0.86\n\n### 现在还不能相信\n\n- **角色质量和任务匹配不能直接相信。**（unverified）：角色库证明有很多角色，不证明每个角色都适合你的具体任务，也不证明角色能产生高质量结果。\n- **不能把角色文案当成真实执行能力。**（unverified）：安装前只能判断角色描述和任务画像是否匹配，不能证明它能在宿主 AI 里完成任务。\n- **真实输出质量不能在安装前相信。**（unverified）：Prompt Preview 只能展示引导方式，不能证明真实项目中的结果质量。\n- **宿主 AI 版本兼容性不能在安装前相信。**（unverified）：Claude、Cursor、Codex、Gemini 等宿主加载规则和版本差异必须在真实环境验证。\n- **不会污染现有宿主 AI 行为，不能直接相信。**（inferred）：Skill、plugin、AGENTS/CLAUDE/GEMINI 指令可能改变宿主 AI 的默认行为。 证据：`CLAUDE.md`\n- **可安全回滚不能默认相信。**（unverified）：除非项目明确提供卸载和恢复说明，否则必须先在隔离环境验证。\n- **真实安装后是否与用户当前宿主 AI 版本兼容？**（unverified）：兼容性只能通过实际宿主环境验证。\n- **项目输出质量是否满足用户具体任务？**（unverified）：安装前预览只能展示流程和边界，不能替代真实评测。\n\n### 继续会触碰什么\n\n- **角色选择偏差**：用户对任务应该由哪个专家角色处理的判断。 原因：选错角色会让 AI 从错误专业视角回答，浪费时间或误导决策。\n- **命令执行**：包管理器、网络下载、本地插件目录、项目配置或用户主目录。 原因：运行第一条命令就可能产生环境改动；必须先判断是否值得跑。 证据：`CLAUDE.md`, `README.md`\n- **宿主 AI 配置**：Claude/Codex/Cursor/Gemini/OpenCode 等宿主的 plugin、Skill 或规则加载配置。 原因：宿主配置会改变 AI 后续工作方式，可能和用户已有规则冲突。 证据：`CLAUDE.md`\n- **本地环境或项目文件**：安装结果、插件缓存、项目配置或本地依赖目录。 原因：安装前无法证明写入范围和回滚方式，需要隔离验证。 证据：`CLAUDE.md`, `README.md`\n- **环境变量 / API Key**：项目入口文档明确出现 API key、token、secret 或账号凭证配置。 原因：如果真实安装需要凭证，应先使用测试凭证并经过权限/合规判断。 证据：`README.md`\n- **宿主 AI 上下文**：AI Context Pack、Prompt Preview、Skill 路由、风险规则和项目事实。 原因：导入上下文会影响宿主 AI 后续判断，必须避免把未验证项包装成事实。\n\n### 最小安全下一步\n\n- **先跑 Prompt Preview**：先用交互式试用验证任务画像和角色匹配，不要先导入整套角色库。（适用：任何项目都适用，尤其是输出质量未知时。）\n- **只在隔离目录或测试账号试装**：避免安装命令污染主力宿主 AI、真实项目或用户主目录。（适用：存在命令执行、插件配置或本地写入线索时。）\n- **先备份宿主 AI 配置**：Skill、plugin、规则文件可能改变 Claude/Cursor/Codex 的默认行为。（适用：存在插件 manifest、Skill 或宿主规则入口时。）\n- **不要使用真实生产凭证**：环境变量/API key 一旦进入宿主或工具链，可能产生账号和合规风险。（适用：出现 API、TOKEN、KEY、SECRET 等环境线索时。）\n- **安装后只验证一个最小任务**：先验证加载、兼容、输出质量和回滚，再决定是否深用。（适用：准备从试用进入真实工作流时。）\n\n### 退出方式\n\n- **保留安装前状态**：记录原始宿主配置和项目状态，后续才能判断是否可恢复。\n- **准备移除宿主 plugin / Skill / 规则入口**：如果试装后行为异常，可以把宿主 AI 恢复到试装前状态。\n- **保留原始角色选择记录**：如果输出偏题，可以回到任务画像阶段重新选择角色，而不是继续沿着错误角色推进。\n- **记录安装命令和写入路径**：没有明确卸载说明时，至少要知道哪些目录或配置需要手动清理。\n- **准备撤销测试 API key 或 token**：测试凭证泄露或误用时，可以快速止损。\n- **如果没有回滚路径，不进入主力环境**：不可回滚是继续前阻断项，不应靠信任或运气继续。\n\n## 哪些只能预览\n\n- 解释项目适合谁和能做什么\n- 基于项目文档演示典型对话流程\n- 帮助用户判断是否值得安装或继续研究\n\n## 哪些必须安装后验证\n\n- 真实安装 Skill、插件或 CLI\n- 执行脚本、修改本地文件或访问外部服务\n- 验证真实输出质量、性能和兼容性\n\n## 边界与风险判断卡\n\n- **把安装前预览误认为真实运行**：用户可能高估项目已经完成的配置、权限和兼容性验证。 处理方式：明确区分 prompt_preview_can_do 与 runtime_required。 Claim：`clm_0006` inferred 0.45\n- **命令执行会修改本地环境**：安装命令可能写入用户主目录、宿主插件目录或项目配置。 处理方式：先在隔离环境或测试账号中运行。 证据：`CLAUDE.md`, `README.md` Claim：`clm_0007` supported 0.86\n- **待确认**：真实安装后是否与用户当前宿主 AI 版本兼容？。原因：兼容性只能通过实际宿主环境验证。\n- **待确认**：项目输出质量是否满足用户具体任务？。原因：安装前预览只能展示流程和边界，不能替代真实评测。\n- **待确认**：安装命令是否需要网络、权限或全局写入？。原因：这影响企业环境和个人环境的安装风险。\n\n## 开工前工作上下文\n\n### 加载顺序\n\n- 先读取 how_to_use.host_ai_instruction，建立安装前判断资产的边界。\n- 读取 claim_graph_summary，确认事实来自 Claim/Evidence Graph，而不是 Human Wiki 叙事。\n- 再读取 intended_users、capabilities 和 quick_start_candidates，判断用户是否匹配。\n- 需要执行具体任务时，优先查 role_skill_index，再查 evidence_index。\n- 遇到真实安装、文件修改、网络访问、性能或兼容性问题时，转入 risk_card 和 boundaries.runtime_required。\n\n### 任务路由\n\n- **命令行启动或安装流程**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`CLAUDE.md`, `README.md` Claim：`clm_0001` supported 0.86\n\n### 上下文规模\n\n- 文件总数：136\n- 重要文件覆盖：39/136\n- 证据索引条目：39\n- 角色 / Skill 条目：21\n\n### 证据不足时的处理\n\n- **missing_evidence**：说明证据不足，要求用户提供目标文件、README 段落或安装后验证记录；不要补全事实。\n- **out_of_scope_request**：说明该任务超出当前 AI Context Pack 证据范围，并建议用户先查看 Human Manual 或真实安装后验证。\n- **runtime_request**：给出安装前检查清单和命令来源，但不要替用户执行命令或声称已执行。\n- **source_conflict**：同时展示冲突来源，标记为待核实，不要强行选择一个版本。\n\n## Prompt Recipes\n\n### 适配判断\n\n- 目标：判断这个项目是否适合用户当前任务。\n- 预期输出：适配结论、关键理由、证据引用、安装前可预览内容、必须安装后验证内容、下一步建议。\n\n```text\n请基于 @modelcontextprotocol/servers 的 AI Context Pack，先问我 3 个必要问题，然后判断它是否适合我的任务。回答必须包含：适合谁、能做什么、不能做什么、是否值得安装、证据来自哪里。所有项目事实必须引用 evidence_refs、source_paths 或 claim_id。\n```\n\n### 安装前体验\n\n- 目标：让用户在安装前感受核心工作流，同时避免把预览包装成真实能力或营销承诺。\n- 预期输出：一段带边界标签的体验剧本、安装后验证清单和谨慎建议；不含真实运行承诺或强营销表述。\n\n```text\n请把 @modelcontextprotocol/servers 当作安装前体验资产，而不是已安装工具或真实运行环境。\n\n请严格输出四段：\n1. 先问我 3 个必要问题。\n2. 给出一段“体验剧本”：用 [安装前可预览]、[必须安装后验证]、[证据不足] 三种标签展示它可能如何引导工作流。\n3. 给出安装后验证清单：列出哪些能力只有真实安装、真实宿主加载、真实项目运行后才能确认。\n4. 给出谨慎建议：只能说“值得继续研究/试装”“先补充信息后再判断”或“不建议继续”，不得替项目背书。\n\n硬性边界：\n- 不要声称已经安装、运行、执行测试、修改文件或产生真实结果。\n- 不要写“自动适配”“确保通过”“完美适配”“强烈建议安装”等承诺性表达。\n- 如果描述安装后的工作方式，必须使用“如果安装成功且宿主正确加载 Skill，它可能会……”这种条件句。\n- 体验剧本只能写成“示例台词/假设流程”：使用“可能会询问/可能会建议/可能会展示”，不要写“已写入、已生成、已通过、正在运行、正在生成”。\n- Prompt Preview 不负责给安装命令；如用户准备试装，只能提示先阅读 Quick Start 和 Risk Card，并在隔离环境验证。\n- 所有项目事实必须来自 supported claim、evidence_refs 或 source_paths；inferred/unverified 只能作风险或待确认项。\n\n```\n\n### 角色 / Skill 选择\n\n- 目标：从项目里的角色或 Skill 中挑选最匹配的资产。\n- 预期输出：候选角色或 Skill 列表，每项包含适用场景、证据路径、风险边界和是否需要安装后验证。\n\n```text\n请读取 role_skill_index，根据我的目标任务推荐 3-5 个最相关的角色或 Skill。每个推荐都要说明适用场景、可能输出、风险边界和 evidence_refs。\n```\n\n### 风险预检\n\n- 目标：安装或引入前识别环境、权限、规则冲突和质量风险。\n- 预期输出：环境、权限、依赖、许可、宿主冲突、质量风险和未知项的检查清单。\n\n```text\n请基于 risk_card、boundaries 和 quick_start_candidates，给我一份安装前风险预检清单。不要替我执行命令，只说明我应该检查什么、为什么检查、失败会有什么影响。\n```\n\n### 宿主 AI 开工指令\n\n- 目标：把项目上下文转成一次对话开始前的宿主 AI 指令。\n- 预期输出：一段边界明确、证据引用明确、适合复制给宿主 AI 的开工前指令。\n\n```text\n请基于 @modelcontextprotocol/servers 的 AI Context Pack，生成一段我可以粘贴给宿主 AI 的开工前指令。这段指令必须遵守 not_runtime=true，不能声称项目已经安装、运行或产生真实结果。\n```\n\n\n## 角色 / Skill 索引\n\n- 共索引 21 个角色 / Skill / 项目文档条目。\n\n- **CLAUDE.md**（project_doc）：This file provides guidance to Claude Code when working with code in this repository. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`CLAUDE.md`\n- **Model Context Protocol servers**（project_doc）：This repository is a collection of reference implementations for the Model Context Protocol https://modelcontextprotocol.io/ MCP , as well as references to community-built servers and additional resources. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`README.md`\n- **MCP \"Everything\" Server - Development Guidelines**（project_doc）：MCP \"Everything\" Server - Development Guidelines 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/AGENTS.md`\n- **Everything MCP Server**（project_doc）：Everything MCP Server Architecture docs/architecture.md Project Structure docs/structure.md Startup Process docs/startup.md Server Features docs/features.md Extension Points docs/extension.md How It Works docs/how-it-works.md 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/README.md`\n- **Fetch MCP Server**（project_doc）：A Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/fetch/README.md`\n- **Filesystem MCP Server**（project_doc）：Node.js server implementing Model Context Protocol MCP for filesystem operations. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/filesystem/README.md`\n- **mcp-server-git: A git MCP server**（project_doc）：A Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/git/README.md`\n- **Knowledge Graph Memory Server**（project_doc）：A basic implementation of persistent memory using a local knowledge graph. This lets Claude remember information about the user across chats. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/memory/README.md`\n- **Sequential Thinking MCP Server**（project_doc）：An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/sequentialthinking/README.md`\n- **Time MCP Server**（project_doc）：A Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/time/README.md`\n- **Contributing to MCP Servers**（project_doc）：Thanks for your interest in contributing! Here's how you can help make this repo better. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`CONTRIBUTING.md`\n- **Everything Server – Architecture**（project_doc）：Architecture Project Structure structure.md Startup Process startup.md Server Features features.md Extension Points extension.md How It Works how-it-works.md 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/docs/architecture.md`\n- **Everything Server - Extension Points**（project_doc）：Everything Server - Extension Points 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/docs/extension.md`\n- **Everything Server - Features**（project_doc）：Architecture architecture.md Project Structure structure.md Startup Process startup.md Server Features Extension Points extension.md How It Works how-it-works.md 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/docs/features.md`\n- **Everything Server - How It Works**（project_doc）：Architecture architecture.md Project Structure structure.md Startup Process startup.md Server Features features.md Extension Points extension.md How It Works 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/docs/how-it-works.md`\n- **Everything Server – Server Instructions**（project_doc）：Everything Server – Server Instructions 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/docs/instructions.md`\n- **Everything Server - Startup Process**（project_doc）：Everything Server - Startup Process 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/docs/startup.md`\n- **Everything Server - Project Structure**（project_doc）：Everything Server - Project Structure 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`src/everything/docs/structure.md`\n- **Description**（project_doc）：Note: We are no longer accepting PRs to add servers to the README. Instead, please publish your server to the MCP Server Registry https://github.com/modelcontextprotocol/registry to make it discoverable to the MCP ecosystem. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`.github/pull_request_template.md`\n- **Contributor Covenant Code of Conduct**（project_doc）：Contributor Covenant Code of Conduct 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`CODE_OF_CONDUCT.md`\n- **Security Policy**（project_doc）：Thank you for helping keep the Model Context Protocol and its ecosystem secure. 激活提示：当用户需要理解项目结构、安装方式或边界时参考。 证据：`SECURITY.md`\n\n## 证据索引\n\n- 共索引 39 条证据。\n\n- **CLAUDE.md**（documentation）：This file provides guidance to Claude Code when working with code in this repository. 证据：`CLAUDE.md`\n- **Model Context Protocol servers**（documentation）：This repository is a collection of reference implementations for the Model Context Protocol https://modelcontextprotocol.io/ MCP , as well as references to community-built servers and additional resources. 证据：`README.md`\n- **MCP \"Everything\" Server - Development Guidelines**（documentation）：MCP \"Everything\" Server - Development Guidelines 证据：`src/everything/AGENTS.md`\n- **Everything MCP Server**（documentation）：Everything MCP Server Architecture docs/architecture.md Project Structure docs/structure.md Startup Process docs/startup.md Server Features docs/features.md Extension Points docs/extension.md How It Works docs/how-it-works.md 证据：`src/everything/README.md`\n- **Fetch MCP Server**（documentation）：A Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption. 证据：`src/fetch/README.md`\n- **Filesystem MCP Server**（documentation）：Node.js server implementing Model Context Protocol MCP for filesystem operations. 证据：`src/filesystem/README.md`\n- **mcp-server-git: A git MCP server**（documentation）：A Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models. 证据：`src/git/README.md`\n- **Knowledge Graph Memory Server**（documentation）：A basic implementation of persistent memory using a local knowledge graph. This lets Claude remember information about the user across chats. 证据：`src/memory/README.md`\n- **Sequential Thinking MCP Server**（documentation）：An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process. 证据：`src/sequentialthinking/README.md`\n- **Time MCP Server**（documentation）：A Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection. 证据：`src/time/README.md`\n- **Package**（package_manifest）：{ \"name\": \"@modelcontextprotocol/servers\", \"private\": true, \"version\": \"0.6.2\", \"description\": \"Model Context Protocol servers\", \"license\": \"SEE LICENSE IN LICENSE\", \"author\": \"Model Context Protocol a Series of LF Projects, LLC.\", \"homepage\": \"https://modelcontextprotocol.io\", \"bugs\": \"https://github.com/modelcontextprotocol/servers/issues\", \"type\": \"module\", \"workspaces\": \"src/ \" , \"files\": , \"scripts\": { \"build\": \"npm run build --workspaces\", \"watch\": \"npm run watch --workspaces\", \"publish-all\": \"npm publish --workspaces --access public\", \"link-all\": \"npm link --workspaces\" }, \"dependencies\": { \"@modelcontextprotocol/server-everything\": \" \", \"@modelcontextprotocol/server-memory\": \" \", \"@… 证据：`package.json`\n- **Contributing to MCP Servers**（documentation）：Thanks for your interest in contributing! Here's how you can help make this repo better. 证据：`CONTRIBUTING.md`\n- **Package**（package_manifest）：{ \"name\": \"@modelcontextprotocol/server-everything\", \"version\": \"2.0.0\", \"description\": \"MCP server that exercises all the features of the MCP protocol\", \"license\": \"SEE LICENSE IN LICENSE\", \"mcpName\": \"io.github.modelcontextprotocol/server-everything\", \"author\": \"Model Context Protocol a Series of LF Projects, LLC.\", \"homepage\": \"https://modelcontextprotocol.io\", \"bugs\": \"https://github.com/modelcontextprotocol/servers/issues\", \"repository\": { \"type\": \"git\", \"url\": \"https://github.com/modelcontextprotocol/servers.git\" }, \"type\": \"module\", \"bin\": { \"mcp-server-everything\": \"dist/index.js\" }, \"files\": \"dist\" , \"scripts\": { \"build\": \"tsc && shx cp -r docs dist/ && shx chmod +x dist/ .js\", \"pr… 证据：`src/everything/package.json`\n- **Package**（package_manifest）：{ \"name\": \"@modelcontextprotocol/server-filesystem\", \"version\": \"0.6.3\", \"description\": \"MCP server for filesystem access\", \"license\": \"SEE LICENSE IN LICENSE\", \"mcpName\": \"io.github.modelcontextprotocol/server-filesystem\", \"author\": \"Model Context Protocol a Series of LF Projects, LLC.\", \"homepage\": \"https://modelcontextprotocol.io\", \"bugs\": \"https://github.com/modelcontextprotocol/servers/issues\", \"repository\": { \"type\": \"git\", \"url\": \"https://github.com/modelcontextprotocol/servers.git\" }, \"type\": \"module\", \"bin\": { \"mcp-server-filesystem\": \"dist/index.js\" }, \"files\": \"dist\" , \"scripts\": { \"build\": \"tsc && shx chmod +x dist/ .js\", \"prepare\": \"npm run build\", \"watch\": \"tsc --watch\", \"test… 证据：`src/filesystem/package.json`\n- **Package**（package_manifest）：{ \"name\": \"@modelcontextprotocol/server-memory\", \"version\": \"0.6.3\", \"description\": \"MCP server for enabling memory for Claude through a knowledge graph\", \"license\": \"SEE LICENSE IN LICENSE\", \"mcpName\": \"io.github.modelcontextprotocol/server-memory\", \"author\": \"Model Context Protocol a Series of LF Projects, LLC.\", \"homepage\": \"https://modelcontextprotocol.io\", \"bugs\": \"https://github.com/modelcontextprotocol/servers/issues\", \"repository\": { \"type\": \"git\", \"url\": \"https://github.com/modelcontextprotocol/servers.git\" }, \"type\": \"module\", \"bin\": { \"mcp-server-memory\": \"dist/index.js\" }, \"files\": \"dist\" , \"scripts\": { \"build\": \"tsc && shx chmod +x dist/ .js\", \"prepare\": \"npm run build\", \"watch… 证据：`src/memory/package.json`\n- **Package**（package_manifest）：{ \"name\": \"@modelcontextprotocol/server-sequential-thinking\", \"version\": \"0.6.2\", \"description\": \"MCP server for sequential thinking and problem solving\", \"license\": \"SEE LICENSE IN LICENSE\", \"mcpName\": \"io.github.modelcontextprotocol/server-sequential-thinking\", \"author\": \"Model Context Protocol a Series of LF Projects, LLC.\", \"homepage\": \"https://modelcontextprotocol.io\", \"bugs\": \"https://github.com/modelcontextprotocol/servers/issues\", \"repository\": { \"type\": \"git\", \"url\": \"https://github.com/modelcontextprotocol/servers.git\" }, \"type\": \"module\", \"bin\": { \"mcp-server-sequential-thinking\": \"dist/index.js\" }, \"files\": \"dist\" , \"scripts\": { \"build\": \"tsc && shx chmod +x dist/ .js\", \"prepare… 证据：`src/sequentialthinking/package.json`\n- **License**（source_file）：The MCP project is undergoing a licensing transition from the MIT License to the Apache License, Version 2.0 \"Apache-2.0\" . All new code and specification contributions to the project are licensed under Apache-2.0. Documentation contributions excluding specifications are licensed under CC-BY-4.0. 证据：`LICENSE`\n- **License**（source_file）：Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files the \"Software\" , to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 证据：`src/fetch/LICENSE`\n- **License**（source_file）：Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files the \"Software\" , to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 证据：`src/git/LICENSE`\n- **Everything Server – Architecture**（documentation）：Architecture Project Structure structure.md Startup Process startup.md Server Features features.md Extension Points extension.md How It Works how-it-works.md 证据：`src/everything/docs/architecture.md`\n- **Everything Server - Extension Points**（documentation）：Everything Server - Extension Points 证据：`src/everything/docs/extension.md`\n- **Everything Server - Features**（documentation）：Architecture architecture.md Project Structure structure.md Startup Process startup.md Server Features Extension Points extension.md How It Works how-it-works.md 证据：`src/everything/docs/features.md`\n- **Everything Server - How It Works**（documentation）：Architecture architecture.md Project Structure structure.md Startup Process startup.md Server Features features.md Extension Points extension.md How It Works 证据：`src/everything/docs/how-it-works.md`\n- **Everything Server – Server Instructions**（documentation）：Everything Server – Server Instructions 证据：`src/everything/docs/instructions.md`\n- **Everything Server - Startup Process**（documentation）：Everything Server - Startup Process 证据：`src/everything/docs/startup.md`\n- **Everything Server - Project Structure**（documentation）：Everything Server - Project Structure 证据：`src/everything/docs/structure.md`\n- **Description**（documentation）：Note: We are no longer accepting PRs to add servers to the README. Instead, please publish your server to the MCP Server Registry https://github.com/modelcontextprotocol/registry to make it discoverable to the MCP ecosystem. 证据：`.github/pull_request_template.md`\n- **Contributor Covenant Code of Conduct**（documentation）：Contributor Covenant Code of Conduct 证据：`CODE_OF_CONDUCT.md`\n- **Security Policy**（documentation）：Thank you for helping keep the Model Context Protocol and its ecosystem secure. 证据：`SECURITY.md`\n- **.Mcp**（structured_config）：{ \"mcpServers\": { \"mcp-docs\": { \"type\": \"http\", \"url\": \"https://modelcontextprotocol.io/mcp\" } } } 证据：`.mcp.json`\n- **Tsconfig**（structured_config）：{ \"compilerOptions\": { \"target\": \"ES2022\", \"module\": \"Node16\", \"moduleResolution\": \"Node16\", \"strict\": true, \"esModuleInterop\": true, \"skipLibCheck\": true, \"forceConsistentCasingInFileNames\": true, \"resolveJsonModule\": true }, \"include\": \"src/ / \" , \"exclude\": \"node modules\" } 证据：`tsconfig.json`\n- **Tsconfig**（structured_config）：{ \"extends\": \"../../tsconfig.json\", \"compilerOptions\": { \"outDir\": \"./dist\", \"rootDir\": \".\" }, \"include\": \"./ / .ts\" } 证据：`src/everything/tsconfig.json`\n- **Tsconfig**（structured_config）：{ \"extends\": \"../../tsconfig.json\", \"compilerOptions\": { \"outDir\": \"./dist\", \"rootDir\": \".\", \"moduleResolution\": \"NodeNext\", \"module\": \"NodeNext\" }, \"include\": \"./ / .ts\" , \"exclude\": \" / tests / \", \" / .test.ts\", \" / .spec.ts\", \"vitest.config.ts\" } 证据：`src/filesystem/tsconfig.json`\n- **Tsconfig**（structured_config）：{ \"extends\": \"../../tsconfig.json\", \"compilerOptions\": { \"outDir\": \"./dist\", \"rootDir\": \".\" }, \"include\": \"./ / .ts\" , \"exclude\": \" / .test.ts\", \"vitest.config.ts\" } 证据：`src/memory/tsconfig.json`\n- **Tsconfig**（structured_config）：{ \"extends\": \"../../tsconfig.json\", \"compilerOptions\": { \"outDir\": \"./dist\", \"rootDir\": \".\" }, \"include\": \"./ / .ts\" , \"exclude\": \" / .test.ts\", \"vitest.config.ts\" } 证据：`src/sequentialthinking/tsconfig.json`\n- **.gitattributes**（source_file）：package-lock.json linguist-generated=true 证据：`.gitattributes`\n- **Logs**（source_file）：Logs logs .log npm-debug.log yarn-debug.log yarn-error.log lerna-debug.log .pnpm-debug.log 证据：`.gitignore`\n- **.npmrc**（source_file）：registry=\"https://registry.npmjs.org/\" @modelcontextprotocol:registry=\"https://registry.npmjs.org/\" 证据：`.npmrc`\n- **!/usr/bin/env uv run --script**（source_file）：!/usr/bin/env uv run --script /// script requires-python = \" =3.12\" dependencies = \"click =8.1.8\", \"tomlkit =0.13.2\" /// import sys import re import click from pathlib import Path import json import tomlkit import datetime import subprocess from dataclasses import dataclass from typing import Any, Iterator, NewType, Protocol 证据：`scripts/release.py`\n\n## 宿主 AI 必须遵守的规则\n\n- **把本资产当作开工前上下文，而不是运行环境。**：AI Context Pack 只包含证据化项目理解，不包含目标项目的可执行状态。 证据：`CLAUDE.md`, `README.md`, `src/everything/AGENTS.md`\n- **回答用户时区分可预览内容与必须安装后才能验证的内容。**：安装前体验的消费者价值来自降低误装和误判，而不是伪装成真实运行。 证据：`CLAUDE.md`, `README.md`, `src/everything/AGENTS.md`\n\n## 用户开工前应该回答的问题\n\n- 你准备在哪个宿主 AI 或本地环境中使用它？\n- 你只是想先体验工作流，还是准备真实安装？\n- 你最在意的是安装成本、输出质量、还是和现有规则的冲突？\n\n## 验收标准\n\n- 所有能力声明都能回指到 evidence_refs 中的文件路径。\n- AI_CONTEXT_PACK.md 没有把预览包装成真实运行。\n- 用户能在 3 分钟内看懂适合谁、能做什么、如何开始和风险边界。\n\n---\n\n## Doramagic Context Augmentation\n\n下面内容用于强化 Repomix/AI Context Pack 主体。Human Manual 只提供阅读骨架；踩坑日志会被转成宿主 AI 必须遵守的工作约束。\n\n## Human Manual 骨架\n\n使用规则：这里只是项目阅读路线和显著性信号，不是事实权威。具体事实仍必须回到 repo evidence / Claim Graph。\n\n宿主 AI 硬性规则：\n- 不得把页标题、章节顺序、摘要或 importance 当作项目事实证据。\n- 解释 Human Manual 骨架时，必须明确说它只是阅读路线/显著性信号。\n- 能力、安装、兼容性、运行状态和风险判断必须引用 repo evidence、source path 或 Claim Graph。\n\n- **项目简介**：importance `high`\n - source_paths: README.md, package.json, CLAUDE.md\n- **仓库结构与构建系统**：importance `high`\n - source_paths: package.json, CLAUDE.md, tsconfig.json, scripts/release.py\n- **Everything 服务器架构**：importance `high`\n - source_paths: src/everything/server/index.ts, src/everything/README.md, src/everything/docs/architecture.md, src/everything/docs/structure.md, src/everything/docs/features.md\n- **传输层与通信协议**：importance `medium`\n - source_paths: src/everything/transports/stdio.ts, src/everything/transports/sse.ts, src/everything/transports/streamableHttp.ts, src/everything/package.json\n- **Filesystem 服务器**：importance `high`\n - source_paths: src/filesystem/index.ts, src/filesystem/package.json, src/filesystem/path-validation.ts, src/filesystem/roots-utils.ts, src/filesystem/README.md\n- **Memory 服务器**：importance `medium`\n - source_paths: src/memory/index.ts, src/memory/package.json, src/memory/README.md\n- **Sequential Thinking 服务器**：importance `medium`\n - source_paths: src/sequentialthinking/index.ts, src/sequentialthinking/lib.ts, src/sequentialthinking/package.json, src/sequentialthinking/README.md\n- **Everything 服务器扩展指南**：importance `medium`\n - source_paths: src/everything/AGENTS.md, src/everything/docs/extension.md, src/everything/docs/startup.md, src/everything/docs/how-it-works.md, src/everything/tools/index.ts\n\n## Repo Inspection Evidence / 源码检查证据\n\n- repo_clone_verified: true\n- repo_inspection_verified: true\n- repo_commit: `4503e2d12b799448cd05f789dd40f9643a8d1a6c`\n- inspected_files: `package.json`, `README.md`, `src/time/pyproject.toml`, `src/time/README.md`, `src/memory/vitest.config.ts`, `src/memory/index.ts`, `src/memory/package.json`, `src/memory/README.md`, `src/memory/tsconfig.json`, `src/everything/AGENTS.md`, `src/everything/vitest.config.ts`, `src/everything/index.ts`, `src/everything/package.json`, `src/everything/README.md`, `src/everything/tsconfig.json`, `src/git/pyproject.toml`, `src/git/README.md`, `src/sequentialthinking/vitest.config.ts`, `src/sequentialthinking/index.ts`, `src/sequentialthinking/package.json`\n\n宿主 AI 硬性规则：\n- 没有 repo_clone_verified=true 时，不得声称已经读过源码。\n- 没有 repo_inspection_verified=true 时，不得把 README/docs/package 文件判断写成事实。\n- 没有 quick_start_verified=true 时，不得声称 Quick Start 已跑通。\n\n## Doramagic Pitfall Constraints / 踩坑约束\n\n这些规则来自 Doramagic 发现、验证或编译过程中的项目专属坑点。宿主 AI 必须把它们当作工作约束，而不是普通说明文字。\n\n### Constraint 1: 能力判断依赖假设\n\n- Trigger: README/documentation is current enough for a first validation pass.\n- Host AI rule: 将假设转成下游验证清单。\n- Why it matters: 假设不成立时，用户拿不到承诺的能力。\n- Evidence: capability.assumptions | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | README/documentation is current enough for a first validation pass.\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 2: 维护活跃度未知\n\n- Trigger: 未记录 last_activity_observed。\n- Host AI rule: 补 GitHub 最近 commit、release、issue/PR 响应信号。\n- Why it matters: 新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- Evidence: evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | last_activity_observed missing\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 3: 下游验证发现风险项\n\n- Trigger: no_demo\n- Host AI rule: 进入安全/权限治理复核队列。\n- Why it matters: 下游已经要求复核，不能在页面中弱化。\n- Evidence: downstream_validation.risk_items | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 4: 存在评分风险\n\n- Trigger: no_demo\n- Host AI rule: 把风险写入边界卡，并确认是否需要人工复核。\n- Why it matters: 风险会影响是否适合普通用户安装。\n- Evidence: risks.scoring_risks | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 5: issue/PR 响应质量未知\n\n- Trigger: issue_or_pr_quality=unknown。\n- Host AI rule: 抽样最近 issue/PR，判断是否长期无人处理。\n- Why it matters: 用户无法判断遇到问题后是否有人维护。\n- Evidence: evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | issue_or_pr_quality=unknown\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 6: 发布节奏不明确\n\n- Trigger: release_recency=unknown。\n- Host AI rule: 确认最近 release/tag 和 README 安装命令是否一致。\n- Why it matters: 安装命令和文档可能落后于代码，用户踩坑概率升高。\n- Evidence: evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | release_recency=unknown\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n",
"summary": "给宿主 AI 的上下文和工作边界。",
"title": "AI Context Pack / 带给我的 AI"
},
"boundary_risk_card": {
"asset_id": "boundary_risk_card",
"filename": "BOUNDARY_RISK_CARD.md",
"markdown": "# Boundary & Risk Card / 安装前决策卡\n\n项目：modelcontextprotocol/servers\n\n## Doramagic 试用结论\n\n当前结论：可以进入发布前推荐检查；首次使用仍应从最小权限、临时目录和可回滚配置开始。\n\n## 用户现在可以做\n\n- 可以先阅读 Human Manual，理解项目目的和主要工作流。\n- 可以复制 Prompt Preview 做安装前体验；这只验证交互感，不代表真实运行。\n- 可以把官方 Quick Start 命令放到隔离环境中验证，不要直接进主力环境。\n\n## 现在不要做\n\n- 不要把 Prompt Preview 当成项目实际运行结果。\n- 不要把 metadata-only validation 当成沙箱安装验证。\n- 不要把未验证能力写成“已支持、已跑通、可放心安装”。\n- 不要在首次试用时交出生产数据、私人文件、真实密钥或主力配置目录。\n\n## 安装前检查\n\n- 宿主 AI 是否匹配：local_cli\n- 官方安装入口状态：已发现官方入口\n- 是否在临时目录、临时宿主或容器中验证：必须是\n- 是否能回滚配置改动：必须能\n- 是否需要 API Key、网络访问、读写文件或修改宿主配置：未确认前按高风险处理\n- 是否记录了安装命令、实际输出和失败日志：必须记录\n\n## 当前阻塞项\n\n- 无阻塞项。\n\n## 项目专属踩坑\n\n- 能力判断依赖假设（medium）：假设不成立时，用户拿不到承诺的能力。 建议检查：将假设转成下游验证清单。\n- 维护活跃度未知（medium）：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 下游验证发现风险项（medium）：下游已经要求复核，不能在页面中弱化。 建议检查：进入安全/权限治理复核队列。\n- 存在评分风险（medium）：风险会影响是否适合普通用户安装。 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- issue/PR 响应质量未知（low）：用户无法判断遇到问题后是否有人维护。 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n\n## 风险与权限提示\n\n- no_demo: medium\n\n## 证据缺口\n\n- 暂未发现结构化证据缺口。\n",
"summary": "安装、权限、验证和推荐前风险。",
"title": "Boundary & Risk Card / 边界与风险卡"
},
"human_manual": {
"asset_id": "human_manual",
"filename": "HUMAN_MANUAL.md",
"markdown": "# https://github.com/modelcontextprotocol/servers 项目说明书\n\n生成时间：2026-05-11 07:54:27 UTC\n\n## 目录\n\n- [项目简介](#page-1)\n- [仓库结构与构建系统](#page-2)\n- [Everything 服务器架构](#page-3)\n- [传输层与通信协议](#page-4)\n- [Filesystem 服务器](#page-5)\n- [Memory 服务器](#page-6)\n- [Sequential Thinking 服务器](#page-7)\n- [Everything 服务器扩展指南](#page-8)\n- [Fetch 服务器](#page-9)\n- [Git 服务器](#page-10)\n\n\n\n## 项目简介\n\n### 相关页面\n\n相关主题：[仓库结构与构建系统](#page-2), [Filesystem 服务器](#page-5), [Fetch 服务器](#page-9)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/modelcontextprotocol/servers/blob/main/README.md)\n- [package.json](https://github.com/modelcontextprotocol/servers/blob/main/package.json)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n \n\n# 项目简介\n\n## 项目概述\n\nModel Context Protocol Servers（简称 MCP Servers）是一个开源的服务器集合仓库，为 [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 提供标准化的工具、资源和提示实现。该项目由 Model Context Protocol 团队维护，旨在为 AI 助手（如 Claude）提供可扩展的上下文访问能力。\n\n项目仓库地址：`https://github.com/modelcontextprotocol/servers`\n\n资料来源：[README.md]()\n\n## 核心功能\n\nMCP Servers 提供了多种类型的服务器实现，使 AI 模型能够：\n\n| 功能类型 | 说明 |\n|---------|------|\n| **文件系统访问** | 读写本地文件、目录操作、文件搜索 |\n| **网络内容获取** | 抓取网页内容、支持 robots.txt 配置 |\n| **时间与时区** | 获取当前时间、时区转换 |\n| **知识图谱存储** | 实体关系管理、持久化记忆 |\n| **通用工具** | 综合测试服务器 |\n| **顺序推理** | 结构化思维推理能力 |\n\n资料来源：[CLAUDE.md]()\n\n## 技术架构\n\n### 服务器类型分布\n\n项目包含两大技术栈的服务器实现：\n\n```mermaid\ngraph TD\n A[MCP Servers 仓库] --> B[TypeScript 服务器]\n A --> C[Python 服务器]\n \n B --> B1[everything]\n B --> B2[filesystem]\n B --> B3[memory]\n B --> B4[sequential-thinking]\n \n C --> C1[fetch]\n C --> C2[time]\n```\n\n### 目录结构\n\n```\nservers/\n├── src/\n│ ├── everything/ # TypeScript 综合测试服务器\n│ ├── filesystem/ # TypeScript 文件系统服务器\n│ ├── memory/ # TypeScript 知识图谱服务器\n│ ├── sequential-thinking/ # TypeScript 顺序推理服务器\n│ ├── fetch/ # Python 网页抓取服务器\n│ └── time/ # Python 时间服务器\n├── README.md\n├── package.json\n└── CLAUDE.md\n```\n\n资料来源：[README.md]()\n\n## 支持的客户端\n\nMCP Servers 可与多种 AI 客户端集成：\n\n| 客户端 | 支持的安装方式 |\n|--------|---------------|\n| **Claude Desktop** | uvx、pip、npm/npx、Docker |\n| **VS Code** | 一键安装按钮、uvx、npx |\n| **Zed** | uvx、pip |\n| **Zencoder** | uvx |\n| **Codex CLI** | npx |\n\n资料来源：[src/fetch/README.md](), [src/filesystem/README.md](), [src/time/README.md]()\n\n## 开发规范\n\n### TypeScript 服务器要求\n\n| 规范项 | 要求 |\n|--------|------|\n| 目标环境 | ES2022, Node16 |\n| 模块系统 | ES modules |\n| 类型检查 | 严格模式 |\n| 测试框架 | vitest + @vitest/coverage-v8 |\n| 输入验证 | Zod schemas |\n| 缩进 | 2 空格 |\n| 命名规范 | 变量/函数 camelCase，类型/类 PascalCase，常量 UPPER_CASE |\n| 文件命名 | kebab-case |\n| 工具命名 | 动词优先 (如 `get-file-info`) |\n\n### Python 服务器要求\n\n| 规范项 | 要求 |\n|--------|------|\n| Python 版本 | >= 3.10 |\n| 构建系统 | hatchling |\n| 包管理器 | uv |\n| 测试框架 | pytest |\n| 类型检查 | pyright |\n| 代码检查 | ruff |\n\n资料来源：[CLAUDE.md]()\n\n## 快速开始\n\n### 使用 uvx 运行（推荐）\n\n```json\n{\n \"mcpServers\": {\n \"server-name\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-name\"]\n }\n }\n}\n```\n\n### 使用 Docker 运行\n\n```json\n{\n \"mcpServers\": {\n \"server-name\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"mcp/server-name\"]\n }\n }\n}\n```\n\n### 本地开发\n\n```bash\n# TypeScript 服务器\ncd src/\nnpm install\nnpm run build\n\n# Python 服务器\ncd src/\nuv sync --frozen --all-extras --dev\nuv run pytest\n```\n\n资料来源：[CLAUDE.md](), [src/fetch/README.md]()\n\n## 主要服务器介绍\n\n### 文件系统服务器 (filesystem)\n\n提供安全的本地文件系统访问能力，支持以下工具：\n\n| 工具名称 | 功能 |\n|----------|------|\n| `read_file` | 读取单个文件内容 |\n| `read_multiple_files` | 批量读取多个文件 |\n| `write_file` | 创建或覆盖文件 |\n| `edit_file` | 编辑文件内容 |\n| `move_file` | 移动/重命名文件 |\n| `list_directory` | 列出目录内容 |\n| `search_files` | 搜索文件 |\n| `get_file_info` | 获取文件元信息 |\n\n文件系统服务器支持配置只读目录，通过 `ro` 标志限制写入权限。\n\n资料来源：[src/filesystem/README.md]()\n\n### 时间服务器 (time)\n\n提供时间和时区相关功能：\n\n- `get_current_time`: 获取当前时间（支持指定时区）\n- `convert_time`: 时区时间转换\n\n支持通过 `--local-timezone` 参数自定义本地时区。\n\n资料来源：[src/time/README.md]()\n\n### 记忆服务器 (memory)\n\n基于知识图谱的持久化存储系统：\n\n| 工具名称 | 功能 |\n|----------|------|\n| `create_entities` | 创建实体 |\n| `create_relations` | 创建实体关系 |\n| `add_observations` | 添加实体观察 |\n| `delete_entities` | 删除实体 |\n| `delete_observations` | 删除观察记录 |\n\n存储格式为 JSONL，可通过 `MEMORY_FILE_PATH` 环境变量自定义存储路径。\n\n资料来源：[src/memory/README.md]()\n\n## 配置示例\n\n### Claude Desktop 配置\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"${workspaceFolder}\"]\n },\n \"fetch\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_fetch\"]\n }\n }\n}\n```\n\n### VS Code 配置\n\n通过一键安装按钮或手动配置 JSON：\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"]\n }\n }\n}\n```\n\n### Windows 特殊配置\n\nWindows 系统可能需要设置环境变量解决字符编码问题：\n\n```json\n{\n \"mcpServers\": {\n \"server-name\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-name\"],\n \"env\": {\n \"PYTHONIOENCODING\": \"utf-8\"\n }\n }\n }\n}\n```\n\n资料来源：[src/fetch/README.md](), [src/filesystem/README.md]()\n\n## 许可协议\n\n本项目采用 MIT License 开源许可协议，允许自由使用、修改和分发软件。\n\n资料来源：[src/sequentialthinking/README.md](), [src/filesystem/README.md]()\n\n## 参与贡献\n\n欢迎提交 Pull Request 贡献代码、修复问题或增强功能。项目接受以下类型的贡献：\n\n- 错误修复\n- 可用性改进\n- 新功能开发\n- 文档完善\n\n建议查看其他 MCP 服务器的实现模式和最佳实践作为参考。\n\n资料来源：[src/fetch/README.md](), [CLAUDE.md]()\n\n---\n\n\n\n## 仓库结构与构建系统\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Everything 服务器架构](#page-3)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [package.json](https://github.com/modelcontextprotocol/servers/blob/main/package.json)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n- [src/everything/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/package.json)\n- [src/memory/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/package.json)\n- [src/filesystem/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/package.json)\n- [src/sequentialthinking/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/package.json)\n \n\n# 仓库结构与构建系统\n\n## 概述\n\nModel Context Protocol (MCP) Servers 仓库是一个**多包 Monorepo**，托管于 GitHub (https://github.com/modelcontextprotocol/servers)，旨在提供标准化的 MCP 服务器实现。该仓库包含多个独立发布的 MCP 服务器，每个服务器封装特定功能域，如文件系统访问、内存管理、HTTP 请求抓取等。\n\n仓库采用 **TypeScript** 作为主要开发语言，使用 **npm** 作为包管理器和构建工具，并通过统一的构建系统确保各服务器的一致性和可维护性。\n\n## 仓库架构\n\n### 整体结构\n\nMCP Servers 仓库采用分层目录结构，每个子目录代表一个独立的 MCP 服务器包：\n\n```\nmodelcontextprotocol/servers/\n├── src/\n│ ├── everything/ # 全功能演示服务器\n│ ├── filesystem/ # 文件系统访问服务器\n│ ├── memory/ # 知识图谱内存服务器\n│ ├── fetch/ # HTTP 请求抓取服务器\n│ ├── time/ # 时间信息服务器\n│ ├── sequentialthinking/ # 顺序推理服务器\n│ └── ... # 其他服务器\n├── scripts/ # 构建和发布脚本\n├── CLAUDE.md # AI 辅助开发指南\n└── package.json # 根级配置（可选）\n```\n\n### 服务器包类型\n\n| 包名称 | 类型 | 主要语言 | 传输协议支持 |\n|--------|------|----------|--------------|\n| server-everything | 全功能演示 | TypeScript | stdio, SSE, Streamable HTTP |\n| server-filesystem | 功能型 | TypeScript | stdio |\n| server-memory | 功能型 | TypeScript | stdio |\n| server-fetch | 功能型 | Python | stdio |\n| server-time | 功能型 | Python | stdio |\n| server-sequentialthinking | 功能型 | TypeScript | stdio |\n\n## 构建系统\n\n### 构建工具链\n\n各 TypeScript 服务器使用统一的构建工具链：\n\n| 工具 | 用途 | 配置位置 |\n|------|------|----------|\n| TypeScript (tsc) | TypeScript 编译 | tsconfig.json |\n| Vitest | 单元测试与覆盖率 | vitest.config.ts |\n| shx | 跨平台 Shell 命令 | - |\n| Prettier | 代码格式化 | .prettierrc |\n\n### 标准构建流程\n\n每个 TypeScript 服务器包定义了标准化的 npm 构建脚本：\n\n```json\n{\n \"scripts\": {\n \"build\": \"tsc && shx chmod +x dist/*.js\",\n \"prepare\": \"npm run build\",\n \"watch\": \"tsc --watch\",\n \"test\": \"vitest run --coverage\"\n }\n}\n```\n\n构建流程包含以下步骤：\n\n```mermaid\ngraph TD\n A[TypeScript 源码] --> B[tsc 编译]\n B --> C{编译成功?}\n C -->|是| D[复制资源文件]\n C -->|否| E[输出错误]\n D --> F[设置可执行权限]\n F --> G[生成 dist/ 目录]\n G --> H[prepare 钩子触发]\n```\n\n**资料来源**：[src/everything/package.json:16-19]()\n\n### 包发布配置\n\n服务器包通过 npm 的标准字段定义发布信息：\n\n```json\n{\n \"name\": \"@modelcontextprotocol/server-everything\",\n \"version\": \"2.0.0\",\n \"description\": \"MCP server that exercises all the features of the MCP protocol\",\n \"type\": \"module\",\n \"bin\": {\n \"mcp-server-everything\": \"dist/index.js\"\n },\n \"files\": [\"dist\"]\n}\n```\n\n**资料来源**：[src/everything/package.json:1-12]()\n\n## 服务器注册模式\n\nMCP 服务器遵循统一的架构模式进行功能注册：\n\n### 核心注册函数\n\n| 注册函数 | 功能 | 适用服务器 |\n|----------|------|------------|\n| `registerTools(server)` | 注册工具能力 | 所有服务器 |\n| `registerResources(server)` | 注册资源能力 | 所有服务器 |\n| `registerPrompts(server)` | 注册提示模板 | 部分服务器 |\n| `registerResourceTemplates(server)` | 注册资源模板 | 部分服务器 |\n\n### 服务器初始化流程\n\n```mermaid\ngraph TD\n A[创建 McpServer 实例] --> B[加载配置参数]\n B --> C[registerTools 调用]\n C --> D[registerResources 调用]\n D --> E[registerPrompts 调用]\n E --> F[初始化传输层]\n F --> G[启动服务器]\n```\n\n**资料来源**：[CLAUDE.md:14-15]()\n\n### 工具注解规范\n\n根据 MCP 规范，工具应设置以下注解以提供语义信息：\n\n```typescript\n{\n annotations: {\n readOnlyHint: boolean, // 是否只读\n idempotentHint: boolean, // 是否幂等\n destructiveHint: boolean // 是否具有破坏性\n }\n}\n```\n\n**资料来源**：[CLAUDE.md:17-19]()\n\n## 传输层支持\n\n### 传输协议类型\n\n| 协议 | 状态 | 启动参数 | 说明 |\n|------|------|----------|------|\n| stdio | ✅ 稳定 | `stdio` | 标准输入输出，默认协议 |\n| SSE | ⚠️ 已弃用 | `sse` | Server-Sent Events，自 2025-03-26 起弃用 |\n| Streamable HTTP | ✅ 稳定 | `streamableHttp` | HTTP 流式传输，当前推荐 |\n\n### 启动命令示例\n\n```bash\n# 启动 stdio 服务器（默认）\nnpx @modelcontextprotocol/server-everything\n\n# 启动 SSE 服务器\nnpx @modelcontextprotocol/server-everything sse\n\n# 启动 Streamable HTTP 服务器\nnpx @modelcontextprotocol/server-everything streamableHttp\n```\n\n**资料来源**：[src/everything/package.json:21-23]()\n\n## 依赖管理\n\n### 核心依赖\n\n所有 TypeScript MCP 服务器共享以下核心依赖：\n\n```json\n{\n \"dependencies\": {\n \"@modelcontextprotocol/sdk\": \"^1.26.0\"\n }\n}\n```\n\n### 可选功能依赖\n\n| 服务器 | 额外依赖 | 用途 |\n|--------|----------|------|\n| filesystem | diff, glob, minimatch, zod-to-json-schema | 文件操作与模式匹配 |\n| sequentialthinking | chalk, yargs | 命令行输出与参数解析 |\n| fetch | httpx, trafilatura | HTTP 请求与内容提取 |\n| everything | cors | 跨域资源共享 |\n\n**资料来源**：[src/filesystem/package.json:26-31]()\n\n## 开发工作流\n\n### 本地开发\n\n```bash\n# 克隆仓库\ngit clone https://github.com/modelcontextprotocol/servers.git\ncd servers\n\n# 进入服务器目录\ncd src/everything\n\n# 安装依赖\nnpm install\n\n# 监听模式开发\nnpm run watch\n\n# 运行测试\nnpm test\n```\n\n### 测试框架\n\n使用 Vitest 进行测试，测试命令为：\n\n```bash\nnpm test\n# 等价于: vitest run --coverage\n```\n\n**资料来源**：[src/everything/package.json:24]()\n\n### 代码质量\n\n```bash\n# 格式化检查\nnpm run prettier:check\n\n# 自动格式化\nnpm run prettier:fix\n```\n\n## 目录结构规范\n\n### 文件命名约定\n\n| 类型 | 命名规范 | 示例 |\n|------|----------|------|\n| 文件/变量 | camelCase | `fileName.ts`, `getUserData()` |\n| 类型/类 | PascalCase | `UserProfile`, `McpServer` |\n| 常量 | UPPER_CASE | `MAX_RETRY_COUNT` |\n| 文件名（kebab-case） | kebab-case | `resource-link.ts` |\n| 工具名称 | kebab-case + 动词 | `get-annotated-message` |\n\n**资料来源**：[src/everything/AGENTS.md:4-6]()\n\n### 模块组织\n\n每个服务器遵循统一的模块划分：\n\n```\nsrc//\n├── server/ # 服务器核心逻辑\n│ ├── index.ts # 主入口\n│ └── logging.ts # 日志工具\n├── tools/ # 工具定义\n│ └── index.ts # 工具注册入口\n├── resources/ # 资源定义\n│ ├── index.ts # 资源注册入口\n│ └── subscriptions.ts # 订阅机制\n├── prompts/ # 提示模板\n│ └── index.ts # 提示注册入口\n├── docs/ # 文档资源\n├── dist/ # 编译输出\n└── package.json # 包配置\n```\n\n**资料来源**：[src/everything/AGENTS.md:15-26]()\n\n## 扩展机制\n\n### 添加新功能\n\n扩展 MCP 服务器的标准流程：\n\n1. **创建模块**：在对应目录（tools/resources/prompts）创建新文件\n2. **定义导出**：导出 `registerX(server)` 函数\n3. **更新索引**：在 `index.ts` 中导入并注册新模块\n4. **编写文档**：更新 `docs/` 目录下的相关文档\n\n```mermaid\ngraph TD\n A[创建新模块文件] --> B[定义 registerX 函数]\n B --> C[导出模块]\n C --> D[更新 index.ts 导入]\n D --> E[注册到服务器]\n E --> F[测试功能]\n F --> G[更新文档]\n```\n\n**资料来源**：[src/everything/AGENTS.md:1-13]()\n\n### 服务器工厂模式\n\n服务器工厂位于 `src/everything/server/index.ts`，负责：\n\n- 初始化时注册所有功能\n- 处理连接后设置\n- 管理生命周期\n\n```typescript\n// 工厂函数签名示例\nexport const createServer = (config: ServerConfig) => McpServer\n```\n\n## 构建系统配置示例\n\n### TypeScript 配置\n\n```json\n{\n \"compilerOptions\": {\n \"target\": \"ES2022\",\n \"module\": \"ESNext\",\n \"moduleResolution\": \"bundler\",\n \"outDir\": \"./dist\",\n \"rootDir\": \"./src\",\n \"strict\": true\n }\n}\n```\n\n### NPM 脚本映射\n\n| 脚本命令 | 实际执行 | 触发时机 |\n|----------|----------|----------|\n| `npm install` | 安装依赖 | 项目初始化 |\n| `npm run build` | tsc + 权限设置 | 发布前 |\n| `npm run prepare` | npm run build | postinstall |\n| `npm run test` | vitest run --coverage | 质量检查 |\n\n**资料来源**：[src/everything/package.json:18]()\n**资料来源**：[src/memory/package.json:16]()\n\n## 快速参考\n\n### 服务器构建检查清单\n\n- [ ] TypeScript 编译无错误\n- [ ] 所有测试通过 (`npm test`)\n- [ ] 代码格式正确 (`npm run prettier:check`)\n- [ ] package.json 字段完整\n- [ ] README.md 文档更新\n- [ ] 发布版本号正确\n\n### 常用命令速查\n\n```bash\n# 构建所有更改\nnpm run build\n\n# 运行测试\nnpm test\n\n# 启动 stdio 传输\nnpm run start:stdio\n\n# 启动 SSE 传输\nnpm run start:sse\n\n# 启动 Streamable HTTP 传输\nnpm run start:streamableHttp\n```\n\n## 总结\n\nMCP Servers 仓库采用成熟的 Monorepo 架构，通过统一的 TypeScript 构建系统和标准化的模块注册模式，实现了多个 MCP 服务器的高效开发和维护。仓库设计遵循清晰的目录规范和命名约定，便于社区贡献和功能扩展。所有服务器共享核心 SDK 依赖，同时保持各自功能域的独立性，通过标准化的传输层接口与 MCP 客户端通信。\n\n---\n\n\n\n## Everything 服务器架构\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [传输层与通信协议](#page-4), [Filesystem 服务器](#page-5)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n- [src/everything/AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md)\n- [src/everything/resources/session.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/resources/session.ts)\n- [src/everything/tools/get-roots-list.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-roots-list.ts)\n- [src/filesystem/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/index.ts)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n \n\n# Everything 服务器架构\n\n## 概述\n\nEverything 服务器是 Model Context Protocol (MCP) 服务器生态中的核心组件之一，旨在提供一个功能全面的参考实现。该服务器作为一个功能展示平台，演示了 MCP 协议的各种能力，包括工具调用、资源管理、提示模板以及多种传输协议支持。Everything 服务器采用模块化架构设计，允许开发者在此基础上进行扩展和定制，以满足特定的业务需求。\n\n该服务器的核心价值在于其示范性——它展示了如何正确实现 MCP 协议的各种特性，同时也是开发新服务器时的参考模板。通过研究 Everything 服务器的架构和实现，开发者可以深入理解 MCP 协议的设计理念和最佳实践。\n\n## 架构设计原则\n\nEverything 服务器的架构设计遵循一系列明确的原则，这些原则确保了代码的可维护性、可扩展性和一致性。\n\n### 模块化组织\n\n服务器采用高度模块化的组织结构，每个功能域都有明确的职责边界。工具（Tools）、资源（Resources）和提示（Prompts）分别位于独立的目录下，通过统一的注册接口与主服务器集成。这种组织方式使得添加新功能变得简单直接，同时降低了代码耦合度，提高了测试的可覆盖性。\n\n核心模块包括：\n\n- `src/everything/tools/` - 工具实现和注册\n- `src/everything/resources/` - 资源管理和订阅\n- `src/everything/prompts/` - 提示模板定义\n- `src/everything/server/` - 服务器核心和日志\n- `src/everything/transports/` - 传输层管理\n- `src/everything/docs/` - 架构和功能文档\n\n### 扩展点机制\n\nEverything 服务器被设计为可在明确的扩展点进行定制。服务器工厂位于 `src/everything/server/index.ts`，负责在启动时注册所有功能组件，并处理连接后的设置工作。资料来源：[src/everything/AGENTS.md:1-20]()\n\n## 核心组件\n\n### 服务器工厂\n\n服务器工厂是 Everything 服务器的中央协调器，负责初始化 MCP 服务器实例并注册所有功能模块。工厂函数接收配置参数，返回配置完整的服务器实例。\n\n```typescript\n// 核心架构伪代码\nexport function createServer(config: ServerConfig): McpServer {\n const server = new McpServer(config);\n registerTools(server);\n registerResources(server);\n registerPrompts(server);\n return server;\n}\n```\n\n### 工具系统\n\n工具是 Everything 服务器提供的核心功能之一。每个工具都是一个独立的模块，遵循统一的注册模式。工具的命名规范要求使用 kebab-case 格式，并以动词开头，例如 `get-annotated-message` 而不是 `annotated-message`。资料来源：[src/everything/AGENTS.md:10-12]()\n\n#### 工具注册模式\n\n所有工具必须导出 `registerX(server)` 函数，该函数接收 MCP SDK 服务器实例并注册相应的工具。工具定义包含以下关键属性：\n\n| 属性 | 说明 | 示例 |\n|------|------|------|\n| name | 工具名称（kebab-case） | `get-file-info` |\n| description | 功能描述 | 工具用途说明 |\n| inputSchema | 输入参数 schema | Zod schema 定义 |\n| outputSchema | 输出结果 schema | 返回值结构定义 |\n| annotations | 提示注解 | readOnlyHint、idempotentHint 等 |\n\n#### 工具注解系统\n\nMCP 协议定义了工具的重要注解，用于向客户端传达工具的行为特性：\n\n| 工具名称 | readOnlyHint | idempotentHint | destructiveHint | 说明 |\n|---------|--------------|----------------|-----------------|------|\n| `read_file` | true | - | - | 纯读取操作 |\n| `read_multiple_files` | true | - | - | 批量读取 |\n| `list_directory` | true | - | - | 列表操作 |\n| `write_file` | false | true | true | 覆盖写入 |\n| `edit_file` | false | false | true | 编辑可能重复应用 |\n| `move_file` | false | false | true | 移动操作会删除源文件 |\n\n资料来源：[src/filesystem/index.ts:1-50]()\n\n### 资源系统\n\n资源系统允许服务器提供可寻址的数据内容。Everything 服务器实现了动态资源注册机制，支持文本和二进制两种资源类型。\n\n#### 资源注册流程\n\n```typescript\nexport const registerSessionResource = (\n server: McpServer,\n resource: Resource,\n type: \"text\" | \"blob\",\n payload: string\n): ResourceLink => {\n // 检查是否已存在同名资源，如存在则移除\n const existingResource = registeredResources.get(uri);\n if (existingResource) {\n existingResource.remove();\n registeredResources.delete(uri);\n }\n\n // 注册新资源\n const registeredResource = server.registerResource(\n name,\n uri,\n { mimeType, description, title, annotations, icons, _meta },\n async () => {\n return {\n contents: [resourceContent],\n };\n }\n );\n\n // 跟踪已注册资源以便后续移除\n registeredResources.set(uri, registeredResource);\n\n return { type: \"resource_link\", ...resource };\n};\n```\n\n资料来源：[src/everything/resources/session.ts:1-65]()\n\n### 提示模板\n\n提示（Prompts）为预定义的交互模板，可被客户端调用。每个提示定义包含名称、描述、参数 schema 和生成逻辑。提示模板存储在 `src/everything/prompts/` 目录下。\n\n### 订阅与更新机制\n\nEverything 服务器实现了资源订阅功能，允许客户端订阅特定资源的变化。订阅例程位于 `src/everything/resources/subscriptions.ts`，支持模拟更新推送。资料来源：[src/everything/AGENTS.md:15]()\n\n### 日志系统\n\n日志辅助模块位于 `src/everything/server/logging.ts`，提供统一的日志记录接口。日志系统与服务器核心 (`src/everything/server/index.ts`) 紧密集成，同时也应用于订阅模块。资料来源：[src/everything/AGENTS.md:16]()\n\n## 传输协议支持\n\nEverything 服务器支持多种传输协议，以适应不同的部署场景和客户端需求。\n\n### 标准输入输出 (stdio)\n\nstdio 是默认的传输方式，适用于命令行工具和本地集成场景。服务器通过标准输入输出流进行 JSON-RPC 通信。\n\n### 服务器发送事件 (SSE)\n\nSSE 传输支持服务器向客户端推送事件。启用方式：\n\n```bash\nnpx @modelcontextprotocol/server-everything sse\n```\n\n从源码运行 SSE 服务器：\n\n```bash\ncd src/everything\nnpm install\nnpm run start:sse\n```\n\n资料来源：[src/everything/README.md:1-30]()\n\n### 流式 HTTP (Streamable HTTP)\n\n流式 HTTP 传输是自 2025-03-26 起推荐的传输方式，取代了 SSE。运行命令：\n\n```bash\nnpx @modelcontextprotocol/server-everything streamableHttp\n```\n\n从源码运行：\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n资料来源：[src/everything/README.md:1-30]()\n\n```mermaid\ngraph TD\n A[客户端] --> B{传输协议选择}\n B --> C[stdio]\n B --> D[SSE]\n B --> E[Streamable HTTP]\n C --> F[标准输入输出通信]\n D --> G[HTTP + Server-Sent Events]\n E --> H[流式 HTTP 响应]\n F --> I[MCP 服务器]\n G --> I\n H --> I\n```\n\n## 目录结构\n\nEverything 服务器遵循标准的 TypeScript 项目结构，目录组织如下：\n\n```\nsrc/everything/\n├── server/\n│ ├── index.ts # 服务器工厂\n│ └── logging.ts # 日志辅助\n├── tools/\n│ ├── index.ts # 工具注册入口\n│ └── *.ts # 各工具实现\n├── resources/\n│ ├── index.ts # 资源注册入口\n│ ├── session.ts # 会话资源\n│ └── subscriptions.ts # 订阅管理\n├── prompts/\n│ ├── index.ts # 提示注册入口\n│ └── *.ts # 提示模板\n├── transports/\n│ └── *.ts # 传输协议实现\n├── docs/\n│ ├── architecture.md # 架构文档\n│ ├── structure.md # 项目结构\n│ ├── features.md # 功能说明\n│ └── extension.md # 扩展指南\n└── package.json\n```\n\n资料来源：[src/everything/AGENTS.md:1-25]()\n\n## 类型命名规范\n\nEverything 服务器对不同类型的代码元素采用了明确的命名约定，这些规范确保了代码库的一致性和可读性：\n\n| 类型 | 命名风格 | 示例 |\n|------|---------|------|\n| 变量和函数 | camelCase | `readMultipleFiles`, `getFileInfo` |\n| 类型和类 | PascalCase | `McpServer`, `ResourceLink` |\n| 常量 | UPPER_CASE | `DEFAULT_TIMEOUT`, `MAX_RETRIES` |\n| 文件名 | kebab-case | `get-roots-list.ts`, `session.ts` |\n| 注册的工具/提示/资源 | kebab-case | `get-file-info`, `list-directory` |\n\n资料来源：[src/everything/AGENTS.md:7-11]()\n\n## 扩展指南\n\n### 添加新工具\n\n添加新工具的步骤如下：\n\n1. 在 `src/everything/tools/` 目录下创建新的工具文件，命名使用 kebab-case\n2. 定义工具的 Zod schema，确保包含准确的描述和示例\n3. 导出 `registerXxx(server)` 函数\n4. 在 `tools/index.ts` 中导入并调用新工具的注册函数\n\n工具 schema 应遵循 JSON Schema 标准，包含完整的类型定义和验证规则。\n\n### 添加新资源\n\n资源扩展遵循类似的模式：\n\n1. 在 `src/everything/resources/` 下创建资源模块\n2. 实现资源内容的生成逻辑\n3. 导出注册函数并在 `resources/index.ts` 中集成\n\n### 添加新提示\n\n提示模板的添加流程：\n\n1. 在 `src/everything/prompts/` 下创建提示定义\n2. 定义提示参数 schema\n3. 实现提示内容生成函数\n4. 在 `prompts/index.ts` 中注册\n\n## MCP 协议特性演示\n\nEverything 服务器作为功能展示平台，演示了 MCP 协议的多个核心特性：\n\n### 根目录 (Roots) 支持\n\n服务器实现了根目录协议能力，通过 `get-roots-list` 工具展示根目录的使用方式。根目录由 MCP 客户端提供，可供需要文件系统访问的服务器使用。资料来源：[src/everything/tools/get-roots-list.ts:1-60]()\n\n```typescript\n// 根目录列表输出格式\nreturn {\n content: [\n {\n type: \"text\",\n text: `Current MCP Roots (${currentRoots!.length} total):\\n\\n${rootsList}\\n\\n` +\n \"Note: This server demonstrates the roots protocol capability...\"\n },\n ],\n};\n```\n\n### 资源注解\n\n服务器展示了对资源的注解支持，包括只读提示、可变性提示和唯一性提示。这些注解帮助客户端理解资源的行为特性。\n\n### 双向通信\n\n通过订阅机制，服务器可以主动向客户端推送更新，实现双向通信模式。\n\n## 构建与部署\n\n### Docker 构建\n\n```bash\ndocker build -t mcp/sequentialthinking -f src/sequentialthinking/Dockerfile .\n```\n\n### 从源码安装\n\n```bash\nnpm install -g @modelcontextprotocol/server-everything@latest\n```\n\n### 开发模式\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n## 许可证\n\nEverything MCP 服务器采用 MIT 许可证授权，这意味着用户可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n---\n\n\n\n## 传输层与通信协议\n\n### 相关页面\n\n相关主题：[Everything 服务器架构](#page-3), [Filesystem 服务器](#page-5)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/everything/transports/stdio.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/stdio.ts)\n- [src/everything/transports/sse.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/sse.ts)\n- [src/everything/transports/streamableHttp.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/streamableHttp.ts)\n- [src/everything/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/package.json)\n- [src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n- [src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n- [src/time/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md)\n \n\n# 传输层与通信协议\n\n## 概述\n\nModel Context Protocol (MCP) 服务器支持多种传输层协议，以适应不同的部署场景和客户端环境。传输层是 MCP 架构中的核心组件，负责在客户端与服务端之间建立通信通道、处理请求与响应的序列化与反序列化，以及管理连接生命周期。\n\nMCP 服务器的传输层设计遵循以下核心原则：\n\n| 设计原则 | 说明 |\n|---------|------|\n| 多协议支持 | 同时支持 stdio、SSE 和 Streamable HTTP 等多种传输协议 |\n| 环境适配 | 针对不同运行环境（本地、容器化、远程）提供最优传输方案 |\n| 协议演进 | 从已弃用的 HTTP+SSE 过渡到标准化的 Streamable HTTP |\n| 标准化接口 | 所有传输层实现遵循统一的 MCP 协议规范 |\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n## 传输层架构\n\nMCP 服务器的传输层采用模块化设计，每种传输协议都有独立的实现模块。项目结构如下：\n\n```\nsrc/everything/\n├── transports/\n│ ├── stdio.ts # 标准输入/输出传输\n│ ├── sse.ts # Server-Sent Events 传输\n│ └── streamableHttp.ts # 流式 HTTP 传输\n├── server/\n│ └── index.ts # 服务器工厂，注册所有传输层\n└── package.json\n```\n\n> 资料来源：[src/everything/transports/stdio.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/stdio.ts)\n\n### 传输层选择决策流程\n\n```mermaid\ngraph TD\n A[开始] --> B{运行环境}\n B -->|本地 Claude Desktop| C[Stdio 传输]\n B -->|Web/浏览器环境| D{SSE vs Streamable HTTP}\n B -->|VS Code / Zed| E{协议版本}\n D -->|旧版协议| F[SSE 传输]\n D -->|2025-03-26 后| G[Streamable HTTP]\n E -->|2025-03-26 前| F\n E -->|2025-03-26 后| H[Streamable HTTP]\n C --> I[进程间通信]\n F --> J[HTTP 长连接]\n G --> K[流式 HTTP 请求/响应]\n H --> K\n```\n\n## Stdio 传输\n\n### 工作原理\n\nStdio（标准输入/输出）是 MCP 服务器的默认传输方式，特别适用于本地进程间通信。当 MCP 客户端在本地启动服务器进程时，通过标准输入读取客户端请求，向标准输出写入服务端响应。\n\n```mermaid\nsequenceDiagram\n participant C as MCP 客户端\n participant S as MCP 服务器进程\n \n Note over C,S: 进程启动\n C->>S: 启动子进程，stdin/stdout 绑定\n C->>S: JSON-RPC 请求 (stdin)\n S->>S: 处理请求\n S->>C: JSON-RPC 响应 (stdout)\n C->>S: 下一个请求 (stdin)\n S->>C: 响应 (stdout)\n```\n\n### 启动命令\n\nStdio 传输是默认模式，无需显式指定：\n\n```bash\n# 默认使用 stdio\nnpx @modelcontextprotocol/server-everything\n\n# 显式指定 stdio\nnpx @modelcontextprotocol/server-everything stdio\n```\n\n### 配置示例\n\n**Claude Desktop 配置：**\n\n```json\n{\n \"mcpServers\": {\n \"everything\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@modelcontextprotocol/server-everything\"]\n }\n }\n}\n```\n\n**Windows 系统配置：**\n\n```json\n{\n \"mcpServers\": {\n \"everything\": {\n \"command\": \"cmd\",\n \"args\": [\"/c\", \"npx\", \"-y\", \"@modelcontextprotocol/server-everything\"]\n }\n }\n}\n```\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n## SSE 传输\n\n### 协议说明\n\nServer-Sent Events (SSE) 是一种基于 HTTP 的单向通信协议，允许服务器主动向客户端推送数据。SSE 传输在 MCP 协议早期版本中被广泛使用。\n\n### 状态说明\n\n| 状态 | 说明 |\n|-----|------|\n| 弃用日期 | 2025-03-26 |\n| 当前状态 | 已弃用，不建议新项目使用 |\n| 替代方案 | Streamable HTTP |\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n### 启动命令\n\n```bash\ncd src/everything\nnpm install\nnpm run start:sse\n```\n\n### 配置示例\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"]\n }\n }\n}\n```\n\n> 资料来源：[src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n\n## Streamable HTTP 传输\n\n### 协议说明\n\nStreamable HTTP 是 MCP 协议的当前标准传输方式，于 2025-03-26 正式成为规范定义的传输层。它支持请求/响应流式传输，提供了比 SSE 更灵活的双向通信能力。\n\n### 工作原理\n\n```mermaid\ngraph LR\n A[HTTP 客户端] -->|1. 建立连接| B[Streamable HTTP 服务器]\n A -->|2. 发送请求流| B\n B -->|3. 返回响应流| A\n A -->|4. 后续请求| B\n B -->|5. 持续响应| A\n```\n\n### 启动命令\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n### 作为独立包运行\n\n```bash\n# 使用 npx 运行\nnpx @modelcontextprotocol/server-everything streamableHttp\n\n# 全局安装后运行\nnpm install -g @modelcontextprotocol/server-everything@latest\n```\n\n> 资料来源：[src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n\n## 传输层配置对比\n\n### 各传输方式特性对比\n\n| 特性 | Stdio | SSE | Streamable HTTP |\n|------|-------|-----|-----------------|\n| 通信方向 | 双向 | 单向（服务端推送） | 双向流式 |\n| 连接类型 | 进程管道 | HTTP 长连接 | HTTP 流式 |\n| 适用场景 | 本地进程 | Web 推送 | Web 应用 |\n| 延迟 | 极低 | 低 | 低至中 |\n| 防火墙友好 | 否 | 是 | 是 |\n| 标准化程度 | MCP 默认 | 已弃用 | MCP 标准 |\n| 状态 | 活跃 | 弃用 | 活跃 |\n\n> 资料来源：[src/everything/transports/streamableHttp.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/streamableHttp.ts)\n\n### 运行时环境配置\n\n#### Docker 环境\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"--mount\", \"type=bind,src=${workspaceFolder},dst=/projects/workspace\",\n \"mcp/filesystem\",\n \"/projects\"\n ]\n }\n }\n}\n```\n\n> 资料来源：[src/filesystem/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)\n\n#### uvx 环境（Python 服务器）\n\n```json\n{\n \"mcpServers\": {\n \"time\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-time\"]\n }\n }\n}\n```\n\n> 资料来源：[src/time/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/time/README.md)\n\n## 工具注册与传输层集成\n\n### 服务器启动流程\n\nMCP 服务器在启动时通过服务器工厂注册传输层。以下是工具注册的典型模式：\n\n```typescript\nserver.registerTool(\n \"write_file\",\n {\n title: \"Write File\",\n description: \"创建新文件或完全覆盖现有文件\",\n inputSchema: { path: z.string(), content: z.string() },\n outputSchema: { content: z.string() },\n annotations: { \n readOnlyHint: false, \n idempotentHint: true, \n destructiveHint: true \n }\n },\n async (args) => {\n // 处理请求逻辑\n }\n);\n```\n\n> 资料来源：[src/filesystem/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/index.ts)\n\n### 资源引用工具示例\n\n```typescript\nexport const registerGetResourceReferenceTool = (server: McpServer) => {\n server.registerTool(name, config, async (args): Promise => {\n // 验证资源类型\n const { resourceType } = args;\n if (!RESOURCE_TYPES.includes(resourceType)) {\n throw new Error(`Invalid resourceType...`);\n }\n \n // 验证资源ID\n const resourceId = Number(args?.resourceId);\n if (!Number.isFinite(resourceId) || resourceId < 1) {\n throw new Error(`Invalid resourceId...`);\n }\n \n // 根据类型获取资源\n const uri = resourceType === RESOURCE_TYPE_TEXT \n ? textResourceUri(resourceId) \n : blobResourceUri(resourceId);\n \n return { content: [...] };\n });\n};\n```\n\n> 资料来源：[src/everything/tools/get-resource-reference.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-resource-reference.ts)\n\n## 调试与测试\n\n### MCP Inspector 使用\n\nMCP Inspector 是官方提供的调试工具，支持所有传输层协议：\n\n```bash\n# 调试 stdio 服务器\nnpx @modelcontextprotocol/inspector uv run mcp-server-time\n\n# 调试 uvx 安装的服务器\nnpx @modelcontextprotocol/inspector uvx mcp-server-fetch\n\n# 调试本地开发服务器\ncd path/to/servers/src/fetch\nnpx @modelcontextprotocol/inspector uv run mcp-server-fetch\n```\n\n> 资料来源：[src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n\n## 最佳实践\n\n### 传输层选择指南\n\n| 场景 | 推荐传输层 |\n|-----|----------|\n| Claude Desktop 本地集成 | Stdio |\n| VS Code / Zed 编辑器 | Stdio 或 Streamable HTTP |\n| Web 应用前端 | Streamable HTTP |\n| 微服务架构 | Streamable HTTP |\n| 遗留系统维护 | SSE（临时）→ Streamable HTTP（迁移） |\n\n### 性能考虑\n\n- **Stdio**：适用于低延迟要求的本地场景，进程启动开销约 50-100ms\n- **Streamable HTTP**：适合需要横向扩展的服务端部署，支持连接复用\n- **SSE**：已弃用，仅用于兼容旧版客户端\n\n> 资料来源：[src/everything/transports/sse.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/transports/sse.ts)\n\n## 技术规格\n\n### 项目技术栈\n\n| 组件 | 规格 |\n|-----|------|\n| TypeScript 目标 | ES2022 |\n| 模块系统 | Node16 |\n| 类型检查 | 严格模式 |\n| Node 版本 | 22+ |\n| 测试框架 | Vitest + @vitest/coverage-v8 |\n\n> 资料来源：[CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n\n## 扩展传输层\n\n### 添加新的传输实现\n\n根据 [AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md) 中的指导，扩展传输层的步骤如下：\n\n1. 在 `src/everything/transports/` 目录下创建新的传输模块文件\n2. 实现标准化的传输接口\n3. 在服务器工厂中注册新传输\n4. 更新 `package.json` 添加对应的 npm scripts\n\n### 命名规范\n\n- 文件命名：kebab-case（例：`custom-transport.ts`）\n- 导出函数：`registerXxxTransport(server)`\n- 内部类型：PascalCase\n\n> 资料来源：[src/everything/AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md)\n\n---\n\n\n\n## Filesystem 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Memory 服务器](#page-6), [Sequential Thinking 服务器](#page-7)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/filesystem/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/index.ts)\n- [src/filesystem/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/package.json)\n- [src/filesystem/path-validation.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/path-validation.ts)\n- [src/filesystem/roots-utils.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/roots-utils.ts)\n- [src/filesystem/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)\n \n\n# Filesystem 服务器\n\n## 概述\n\nFilesystem 服务器是 Model Context Protocol (MCP) 生态系统中专门用于文件系统操作的 MCP 服务器实现。该服务器为 AI 模型提供了一套完整的文件系统交互工具，使其能够在受控和安全的沙箱环境中读取、写入、搜索和管理本地文件系统中的文件和目录。资料来源：[src/filesystem/README.md]()\n\n## 核心功能\n\nFilesystem 服务器的核心职责是为 AI 助手提供文件系统访问能力，同时通过路径验证和沙箱机制确保操作的安全性。该服务器遵循 MCP 协议规范，支持通过 stdio、Streamable HTTP 和 SSE 等多种传输协议进行通信。资料来源：[src/filesystem/index.ts:1-50]()\n\n## 架构设计\n\n### 整体架构\n\n```mermaid\ngraph TD\n A[AI 模型] -->|MCP 协议| B[Filesystem 服务器]\n B -->|stdin/stdout| A\n B -->|路径验证| C[沙箱目录]\n B -->|Roots API| D[配置的根目录]\n C -->|文件操作| E[本地文件系统]\n \n F[read_text_file] -->|纯读取| C\n G[read_media_file] -->|纯读取| C\n H[write_file] -->|写入操作| C\n I[edit_file] -->|编辑操作| C\n J[move_file] -->|移动操作| C\n K[create_directory] -->|创建操作| C\n```\n\n### 工具分类\n\nFilesystem 服务器将所有工具按功能特性进行标注，每个工具都包含 `readOnlyHint`、`idempotentHint` 和 `destructiveHint` 三个关键注解，用于指示工具的行为特性。资料来源：[src/filesystem/README.md]()\n\n## 工具 API\n\n### 读取类工具\n\n| 工具名称 | 读取操作 | 幂等操作 | 破坏性操作 | 说明 |\n|---------|---------|---------|-----------|------|\n| `read_text_file` | ✓ | - | - | 纯文本读取 |\n| `read_media_file` | ✓ | - | - | 纯读取 |\n| `read_multiple_files` | ✓ | - | - | 纯读取 |\n| `list_directory` | ✓ | - | - | 纯读取 |\n| `list_directory_with_sizes` | ✓ | - | - | 纯读取 |\n| `directory_tree` | ✓ | - | - | 纯读取 |\n| `search_files` | ✓ | - | - | 纯读取 |\n| `get_file_info` | ✓ | - | - | 纯读取 |\n| `list_allowed_directories` | ✓ | - | - | 纯读取 |\n\n### 写入类工具\n\n| 工具名称 | 读取操作 | 幂等操作 | 破坏性操作 | 说明 |\n|---------|---------|---------|-----------|------|\n| `create_directory` | ✗ | ✓ | ✗ | 重建相同目录为空操作 |\n| `write_file` | ✗ | ✓ | ✓ | 覆盖现有文件 |\n| `edit_file` | ✗ | ✗ | ✓ | 重新应用编辑可能失败或重复应用 |\n| `move_file` | ✗ | ✗ | ✓ | 删除源文件 |\n\n> 注意：根据 MCP 协议规范，`idempotentHint` 和 `destructiveHint` 仅在 `readOnlyHint` 为 `false` 时才有意义。资料来源：[src/filesystem/README.md]()\n\n### read_text_file\n\n读取文件的完整文本内容作为纯文本返回。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `path` | string | 是 | 文件路径 |\n| `head` | number | 否 | 返回前 N 行 |\n| `tail` | number | 否 | 返回最后 N 行 |\n\n**使用限制：**\n\n- 不能同时指定 `head` 和 `tail`\n- 无论文件扩展名如何，始终将文件视为 UTF-8 文本处理\n- 仅在允许的目录范围内工作\n\n资料来源：[src/filesystem/README.md]()\n\n### read_media_file\n\n读取图像或音频文件，以 base64 编码的数据和对应的 MIME 类型返回。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `path` | string | 是 | 文件路径 |\n\n**返回格式：**\n\n```json\n{\n \"mimeType\": \"image/png\",\n \"data\": \"\"\n}\n```\n\n### read_multiple_files\n\n同时读取多个文件内容。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `paths` | string[] | 是 | 文件路径数组 |\n\n**特性：** 单个文件读取失败不会中断整个操作，失败的读取会返回错误信息。资料来源：[src/filesystem/index.ts]()\n\n### write_file\n\n创建新文件或完全覆盖现有文件内容。\n\n**输入参数：**\n\n| 参数 | 类型 | 必填 | 说明 |\n|-----|------|------|------|\n| `path` | string | 是 | 文件路径 |\n| `content` | string | 是 | 文件内容 |\n\n**安全提示：** 此操作会覆盖现有文件，使用时需谨慎。资料来源：[src/filesystem/index.ts]()\n\n### edit_file\n\n使用高级模式匹配和格式化进行选择性编辑。\n\n**支持的功能：**\n\n- 基于行和多行内容匹配\n- 保留缩进格式的空白符规范化\n- 多个同时编辑，位置计算正确\n- 缩进风格自动检测和保留\n- 带上下文的 Git 风格 diff 输出\n- 预览更改的干运行模式\n\n**输入参数：**\n\n```typescript\n{\n path: string; // 要编辑的文件路径\n edits: Array<{\n oldText: string; // 要搜索的文本（可以是子字符串）\n newText: string; // 替换的新文本\n }>;\n}\n```\n\n资料来源：[src/filesystem/README.md]()\n\n### 目录管理工具\n\n| 工具名称 | 功能描述 |\n|---------|---------|\n| `create_directory` | 创建新目录 |\n| `list_directory` | 列出目录内容 |\n| `list_directory_with_sizes` | 列出目录内容及文件大小 |\n| `directory_tree` | 显示目录树结构 |\n| `move_file` | 移动或重命名文件/目录 |\n\n### 搜索与信息工具\n\n| 工具名称 | 功能描述 |\n|---------|---------|\n| `search_files` | 在目录中搜索文件 |\n| `get_file_info` | 获取文件元数据信息 |\n| `list_allowed_directories` | 列出允许访问的目录 |\n\n## 安全机制\n\n### 路径验证\n\nFilesystem 服务器实现了严格的路径验证机制，确保所有文件操作都在配置的沙箱目录范围内进行。路径验证模块 (`path-validation.ts`) 负责检查每个文件路径是否在允许访问的目录树内。资料来源：[src/filesystem/path-validation.ts]()\n\n### 根目录 (Roots)\n\n服务器使用 MCP 的 Roots 机制来定义允许访问的目录范围。通过 `roots-utils.ts` 模块，服务器可以动态获取和验证允许的根目录列表。资料来源：[src/filesystem/roots-utils.ts]()\n\n### 操作注解\n\n服务器为每个工具提供标准化的注解，帮助 AI 模型理解工具行为的潜在影响：\n\n```mermaid\ngraph LR\n A[工具执行] --> B{readOnlyHint}\n B -->|true| C[安全执行]\n B -->|false| D{检查幂等性}\n D -->|idempotentHint| E[可安全重复执行]\n D -->|destructiveHint| F[可能产生破坏性后果]\n```\n\n## 安装与配置\n\n### Claude Desktop 配置\n\n#### Docker 安装\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"--mount\", \"type=bind,src=/Users/username/Desktop,dst=/projects/Desktop\",\n \"--mount\", \"type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro\",\n \"mcp/filesystem\",\n \"/projects\"\n ]\n }\n }\n}\n```\n\n> 注意：所有目录必须挂载到容器的 `/projects` 路径。添加 `ro` 标志会使目录对服务器只读。资料来源：[src/filesystem/README.md]()\n\n#### NPX 安装\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@modelcontextprotocol/server-filesystem\",\n \"/Users/username/Desktop\",\n \"/path/to/other/allowed/dir\"\n ]\n }\n }\n}\n```\n\n#### Windows 配置\n\n在 Windows 上，使用 `cmd /c` 启动 npx：\n\n```json\n{\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"cmd\",\n \"args\": [\n \"/c\",\n \"npx\",\n \"-y\",\n \"@modelcontextprotocol/server-filesystem\",\n \"${workspaceFolder}\"\n ]\n }\n }\n}\n```\n\n### VS Code 配置\n\n通过一键安装按钮快速配置：\n\n[](https://insiders.vscode.dev/redirect/mcp/install?name=filesystem&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-filesystem%22%2C%22%24%7BworkspaceFolder%7D%22%5D%7D)\n\n### Docker 构建\n\n手动构建 Docker 镜像：\n\n```bash\ndocker build -t mcp/filesystem -f src/filesystem/Dockerfile .\n```\n\n## 项目结构\n\n```\nsrc/filesystem/\n├── index.ts # 主入口文件，定义所有工具\n├── path-validation.ts # 路径验证模块\n├── roots-utils.ts # 根目录工具模块\n├── package.json # NPM 包配置\n├── tsconfig.json # TypeScript 配置\n└── Dockerfile # Docker 镜像配置\n```\n\n### package.json 主要配置\n\n```json\n{\n \"name\": \"@modelcontextprotocol/server-filesystem\",\n \"version\": \"最新版本\",\n \"type\": \"module\",\n \"description\": \"MCP 服务器，提供文件系统访问能力\"\n}\n```\n\n资料来源：[src/filesystem/package.json]()\n\n## 开发指南\n\n### 运行环境\n\n- **Node.js 版本：** Node 22\n- **TypeScript 目标：** ES2022\n- **模块系统：** Node16\n- **测试框架：** Vitest\n- **类型检查：** TypeScript strict 模式\n\n### 代码规范\n\n- 使用 ES modules，导入路径带 `.js` 扩展名\n- 所有函数和变量使用严格的 TypeScript 类型\n- 使用 Zod schema 进行工具输入验证\n- 2 空格缩进，多行对象使用尾随逗号\n- 变量/函数使用 camelCase\n- 类型/类使用 PascalCase\n- 常量使用 UPPER_CASE\n- 文件名和注册工具使用 kebab-case\n- 工具名称使用动词优先（如 `get-file-info`）资料来源：[CLAUDE.md]()\n\n### 运行测试\n\n```bash\nnpm install\nnpm test\n```\n\n## 许可证\n\nFilesystem 服务器采用 MIT 许可证开源，允许自由使用、修改和分发软件。资料来源：[src/filesystem/README.md]()\n\n---\n\n\n\n## Memory 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Filesystem 服务器](#page-5), [Sequential Thinking 服务器](#page-7)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/memory/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/index.ts)\n- [src/memory/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/package.json)\n- [src/memory/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/memory/README.md)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n- [src/everything/resources/session.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/resources/session.ts)\n- [src/everything/tools/get-resource-reference.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-resource-reference.ts)\n \n\n# Memory 服务器\n\n## 概述\n\nMemory 服务器是 Model Context Protocol (MCP) 生态系统中专注于知识图谱与记忆管理的 MCP 服务器实现。该服务器通过知识图谱结构为 AI 助手提供持久化记忆能力，使模型能够在多轮对话中保持上下文一致性，并主动管理用户信息、行为模式和偏好设置。\n\n核心特性包括：\n\n- 基于知识图谱的实体与关系存储\n- JSONL 格式的持久化存储\n- 支持记忆的创建、检索与更新操作\n- 与 Claude 等 MCP 客户端无缝集成\n\n资料来源：[src/memory/package.json:3-4]()\n\n## 核心功能\n\n### 知识图谱管理\n\nMemory 服务器采用实体-关系模型组织信息，支持以下核心实体类型：\n\n| 实体类型 | 描述 | 关系示例 |\n|---------|------|---------|\n| 用户身份 | 基本身份信息（年龄、性别、位置、职位等） | `has_identity` |\n| 行为数据 | 兴趣、习惯等行为信息 | `has_behavior` |\n| 偏好设置 | 沟通风格、首选语言等 | `has_preference` |\n| 目标规划 | 目标、期望、 aspirations | `has_goal` |\n| 关系网络 | 个人与职业关系（最多3度分离） | `knows`, `works_with` |\n\n### 记忆操作流程\n\n```mermaid\ngraph TD\n A[用户交互] --> B{是否识别用户}\n B -->|否| C[尝试识别用户]\n B -->|是| D[检索相关记忆]\n C --> D\n D --> E{发现新信息?}\n E -->|是| F[更新知识图谱]\n E -->|否| G[继续对话]\n F --> H[创建实体/关系]\n H --> G\n G --> I[响应用户]\n \n style F fill:#e1f5fe\n style H fill:#e1f5fe\n```\n\n资料来源：[src/memory/README.md:73-88]()\n\n## 系统架构\n\n### 组件架构图\n\n```mermaid\ngraph TD\n subgraph 客户端层\n A[Claude / MCP Client]\n end\n \n subgraph MCP 协议层\n B[Stdio Transport]\n C[HTTP + SSE Transport]\n end\n \n subgraph Memory 服务器\n D[知识图谱引擎]\n E[JSONL 存储适配器]\n F[实体管理器]\n G[关系管理器]\n end\n \n subgraph 存储层\n H[memory.jsonl]\n end\n \n A --> B\n A --> C\n B --> D\n C --> D\n D --> E\n E --> H\n D --> F\n D --> G\n F -.->|管理| H\n G -.->|管理| H\n```\n\n### 技术栈\n\n| 组件 | 技术选型 | 版本要求 |\n|------|---------|---------|\n| 运行时 | Node.js | 22+ |\n| 语言 | TypeScript | ES2022 |\n| SDK | @modelcontextprotocol/sdk | ^1.26.0 |\n| 包管理 | npm | - |\n| 测试框架 | vitest | ^2.1.8 |\n| 类型检查 | TypeScript | ^5.6.2 |\n\n资料来源：[src/memory/package.json:8-31]()\n\n## 安装与配置\n\n### 环境要求\n\n- Node.js 22 或更高版本\n- npm 或 yarn 包管理器\n\n### 安装方式\n\n#### NPX 方式\n\n适用于快速测试和临时使用场景：\n\n```json\n{\n \"mcpServers\": {\n \"memory\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@modelcontextprotocol/server-memory\"\n ],\n \"env\": {\n \"MEMORY_FILE_PATH\": \"/path/to/custom/memory.jsonl\"\n }\n }\n }\n}\n```\n\n资料来源：[src/memory/README.md:1-14]()\n\n#### Windows 配置\n\n在 Windows 系统上需要使用 `cmd` 作为入口：\n\n```json\n{\n \"mcpServers\": {\n \"memory\": {\n \"command\": \"cmd\",\n \"args\": [\n \"/c\",\n \"npx\",\n \"-y\",\n \"@modelcontextprotocol/server-memory\"\n ],\n \"env\": {\n \"MEMORY_FILE_PATH\": \"C:\\\\path\\\\to\\\\memory.jsonl\"\n }\n }\n }\n}\n```\n\n资料来源：[src/memory/README.md:17-32]()\n\n#### Docker 方式\n\n适用于生产环境和隔离部署：\n\n```json\n{\n \"mcpServers\": {\n \"memory\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"-v\",\n \"claude-memory:/app/dist\",\n \"--rm\",\n \"mcp/memory\"\n ]\n }\n }\n}\n```\n\n### VS Code 快速安装\n\n支持一键安装按钮，可在 VS Code Insiders 中快速配置：\n\n```markdown\n[](https://insiders.vscode.dev/redirect/mcp/install?name=memory&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-memory%22%5D%7D)\n```\n\n资料来源：[src/memory/README.md:44-45]()\n\n## 配置选项\n\n### 环境变量\n\n| 变量名 | 类型 | 默认值 | 描述 |\n|--------|------|--------|------|\n| `MEMORY_FILE_PATH` | string | `memory.jsonl` (服务器目录内) | 记忆存储 JSONL 文件的路径 |\n\n### 配置文件结构\n\n```mermaid\ngraph LR\n A[memory.jsonl] --> B{记录格式}\n B --> C[JSONL 每行一个 JSON 对象]\n C --> D[实体定义]\n C --> E[关系定义]\n \n D --> D1[id]\n D --> D2[type]\n D --> D3[properties]\n \n E --> E1[source]\n E --> E2[target]\n E --> E3[relation_type]\n```\n\n#### JSONL 存储格式示例\n\n```jsonl\n{\"id\": \"entity_1\", \"type\": \"user\", \"properties\": {\"name\": \"张三\", \"job\": \"工程师\"}}\n{\"id\": \"entity_2\", \"type\": \"interest\", \"properties\": {\"category\": \"技术\", \"topics\": [\"AI\", \"区块链\"]}}\n{\"source\": \"entity_1\", \"target\": \"entity_2\", \"relation_type\": \"has_interest\"}\n```\n\n资料来源：[src/memory/README.md:14]()\n\n## 使用方法\n\n### 系统提示词配置\n\n为实现个性化聊天体验，建议在 Claude.ai Project 的\"自定义说明\"字段中添加以下提示词：\n\n```\nFollow these steps for each interaction:\n\n1. User Identification:\n - You should assume that you are interacting with default_user\n - If you have not identified default_user, proactively try to do so.\n\n2. Memory Retrieval:\n - Always begin your chat by saying only \"Remembering...\" and retrieve all relevant information from your knowledge graph\n - Always refer to your knowledge graph as your \"memory\"\n\n3. Memory\n - While conversing with the user, be attentive to any new information that falls into these categories:\n a) Basic Identity (age, gender, location, job title, education level, etc.)\n b) Behaviors (interests, habits, etc.)\n c) Preferences (communication style, preferred language, etc.)\n d) Goals (goals, targets, aspirations, etc.)\n e) Relationships (personal and professional relationships up to 3 degrees of separation)\n\n4. Memory Update:\n - If any new information was gathered during the interaction, update your memory as follows:\n a) Create entities for recurring organizations, people, and significant events\n b) Connect them to the current entities using relations\n```\n\n资料来源：[src/memory/README.md:73-94]()\n\n### 记忆检索流程\n\n```mermaid\nsequenceDiagram\n participant U as 用户\n participant C as Claude\n participant M as Memory 服务器\n participant KG as 知识图谱\n \n U->>C: 开始对话\n C->>M: 检索相关记忆\n M->>KG: 查询实体与关系\n KG-->>M: 返回记忆数据\n M-->>C: 格式化记忆\n C->>U: \"Remembering...\" + 相关记忆\n U->>C: 继续对话\n C->>M: 更新记忆（如有新信息）\n M->>KG: 创建/更新实体关系\n```\n\n### 记忆分类\n\n| 类别 | 内容 | 优先级 |\n|------|------|--------|\n| 基础身份 | 年龄、性别、位置、职位、学历等 | 高 |\n| 行为模式 | 兴趣、习惯等 | 中 |\n| 偏好设置 | 沟通风格、首选语言等 | 中 |\n| 目标规划 | 目标、期望、志向等 | 高 |\n| 关系网络 | 个人与职业关系（最多3度分离） | 中 |\n\n## 开发者指南\n\n### 本地开发\n\n#### 克隆与安装\n\n```bash\ngit clone https://github.com/modelcontextprotocol/servers.git\ncd servers/src/memory\nnpm install\n```\n\n#### 构建\n\n```bash\nnpm run build\n```\n\n构建产物输出至 `dist/` 目录，TypeScript 编译目标为 ES2022，模块系统为 Node16。\n\n资料来源：[CLAUDE.md:6-9]()\n\n#### 开发模式监视\n\n```bash\nnpm run watch\n```\n\n此命令启动 TypeScript 编译器监视模式，文件变更时自动重新编译。\n\n#### 测试\n\n```bash\nnpm run test\n```\n\n测试框架采用 vitest，支持覆盖率报告：\n\n```bash\nnpm test -- --coverage\n```\n\n### 代码规范\n\n#### TypeScript 规范\n\n- 使用 ES modules，导入路径带 `.js` 扩展名\n- 严格 TypeScript 类型检查\n- 使用 Zod schemas 进行工具输入验证\n- 2 空格缩进，多行对象保留尾随逗号\n- 变量/函数命名：camelCase\n- 类型/类命名：PascalCase\n- 常量命名：UPPER_CASE\n- 文件名：kebab-case\n\n资料来源：[CLAUDE.md:24-30]()\n\n### 项目结构\n\n```\nsrc/memory/\n├── index.ts # 主入口文件\n├── package.json # 项目配置\n├── tsconfig.json # TypeScript 配置\n├── dist/ # 编译输出目录\n└── test/ # 测试文件目录\n```\n\n## API 参考\n\n### MCP 工具接口\n\nMemory 服务器提供以下 MCP 协议接口：\n\n| 工具名称 | 输入参数 | 返回类型 | 描述 |\n|---------|---------|---------|------|\n| 记忆检索 | query | Memory[] | 根据查询条件检索记忆 |\n| 记忆创建 | entity, relations | Memory | 创建新实体和关系 |\n| 记忆更新 | id, updates | Memory | 更新现有实体 |\n| 记忆删除 | id | boolean | 删除指定实体及关联关系 |\n\n### 资源接口\n\n```typescript\ninterface Resource {\n uri: string; // 资源唯一标识符\n name: string; // 资源名称\n mimeType: string; // MIME 类型\n description?: string; // 资源描述\n annotations?: object; // 注解信息\n}\n```\n\n资料来源：[src/everything/resources/session.ts:1-9]()\n\n## 版本信息\n\n| 版本 | 发布日期 | 关键更新 |\n|------|---------|---------|\n| 0.6.3 | 当前版本 | 知识图谱优化、存储增强 |\n\n当前包版本信息存储于 `package.json` 的 `version` 字段：\n\n```json\n{\n \"name\": \"@modelcontextprotocol/server-memory\",\n \"version\": \"0.6.3\",\n \"description\": \"MCP server for enabling memory for Claude through a knowledge graph\"\n}\n```\n\n资料来源：[src/memory/package.json:2-4]()\n\n## 相关资源\n\n- [MCP 官方文档](https://modelcontextprotocol.io)\n- [MCP 协议规范](https://modelcontextprotocol.io/specification)\n- [Memory 服务器 Issues](https://github.com/modelcontextprotocol/servers/issues)\n- [MCP 服务器示例仓库](https://github.com/modelcontextprotocol/servers)\n\n---\n\n\n\n## Sequential Thinking 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Everything 服务器架构](#page-3), [Filesystem 服务器](#page-5)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/sequentialthinking/index.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/index.ts)\n- [src/sequentialthinking/lib.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/lib.ts)\n- [src/sequentialthinking/package.json](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/package.json)\n- [src/sequentialthinking/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/sequentialthinking/README.md)\n \n\n# Sequential Thinking 服务器\n\n## 概述\n\nSequential Thinking 服务器是 Model Context Protocol (MCP) 生态系统中的一款 MCP 服务器，专门提供顺序推理（Sequential Thinking）能力。该服务器允许 AI 模型执行链式思维推理过程，通过结构化的思考步骤来分解和解决复杂问题。\n\n该服务器的核心价值在于为 AI 助手提供一种可控、可追溯的推理框架，使模型能够在处理多步骤问题时保持逻辑连贯性，并能够回溯和修正推理路径。\n\n## 核心功能\n\n### 链式思维推理\n\nSequential Thinking 服务器提供了一套完整的链式思维推理工具集，使 AI 模型能够：\n\n- 将复杂问题分解为多个可管理的推理步骤\n- 沿着逻辑链路逐步推进思考过程\n- 在每个步骤中记录中间结果和推理依据\n- 支持条件分支和回溯操作\n\n### 思考日志管理\n\n服务器内置思考日志功能，可记录整个推理过程的详细信息。通过环境变量 `DISABLE_THOUGHT_LOGGING` 可以控制是否记录思考日志：\n\n```bash\n# 禁用思考日志记录\nexport DISABLE_THOUGHT_LOGGING=true\n```\n\n```json\n// 在 JSON 配置中设置\n{\n \"env\": {\n \"DISABLE_THOUGHT_LOGGING\": \"true\"\n }\n}\n```\n\n## 架构设计\n\n### 系统架构图\n\n```mermaid\ngraph TD\n A[客户端/AI模型] --> B[Sequential Thinking 服务器]\n B --> C[推理引擎]\n C --> D[状态管理器]\n D --> E[日志系统]\n C --> F[工具集]\n \n F --> F1[分解问题工具]\n F --> F2[推理步骤工具]\n F --> F3[回溯工具]\n F --> F4[总结工具]\n \n E -->|可选| G[外部日志服务]\n```\n\n### 组件关系\n\n| 组件 | 职责 | 数据流向 |\n|------|------|----------|\n| 推理引擎 | 处理链式思维逻辑 | 接收输入 → 执行推理 → 输出结果 |\n| 状态管理器 | 维护推理上下文状态 | 存储当前状态 → 支持回溯 |\n| 日志系统 | 记录推理过程 | 捕获步骤 → 格式化日志 |\n| 工具集 | 提供可调用接口 | 暴露给 MCP 客户端 |\n\n## 安装与配置\n\n### 环境要求\n\n- Node.js 环境（推荐 Node 22+）\n- Docker（可选，用于容器化部署）\n\n### 安装方式\n\n#### 方式一：NPX 远程执行\n\n**macOS/Linux 配置：**\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@modelcontextprotocol/server-sequential-thinking\"\n ]\n }\n }\n}\n```\n\n**Windows 配置：**\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"cmd\",\n \"args\": [\n \"/c\",\n \"npx\",\n \"-y\",\n \"@modelcontextprotocol/server-sequential-thinking\"\n ]\n }\n }\n}\n```\n\n#### 方式二：Docker 容器部署\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"mcp/sequentialthinking\"\n ]\n }\n }\n}\n```\n\n**Docker 构建命令：**\n\n```bash\ndocker build -t mcp/sequentialthinking -f src/sequentialthinking/Dockerfile .\n```\n\n### Claude Desktop 配置\n\n在 `claude_desktop_config.json` 中添加以下配置：\n\n```json\n{\n \"servers\": {\n \"sequential-thinking\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@modelcontextprotocol/server-sequential-thinking\"]\n }\n }\n}\n```\n\n### VS Code 配置\n\n支持一键安装，可通过 VS Code 安装按钮直接添加：\n\n- [Install with NPX in VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=sequentialthinking&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-sequential-thinking%22%5D%7D)\n- [Install with NPX in VS Code Insiders](https://insiders.vscode.dev/redirect/mcp/install?name=sequentialthinking&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-sequential-thinking%22%5D%7D&quality=insiders)\n\n## 使用方法\n\n### 与 Codex CLI 集成\n\n使用 npx 运行 Sequential Thinking 服务器：\n\n```bash\ncodex mcp add sequential-thinking npx -y @modelcontextprotocol/server-sequential-thinking\n```\n\n### 典型工作流程\n\n```mermaid\ngraph LR\n A[输入复杂问题] --> B[分解为子问题]\n B --> C[执行第一步推理]\n C --> D{是否完成?}\n D -->|否| E[记录中间结果]\n E --> F[执行下一步推理]\n F --> D\n D -->|是| G[生成最终答案]\n```\n\n## 工具接口\n\n### 可用工具\n\n| 工具名称 | 功能描述 | 使用场景 |\n|----------|----------|----------|\n| `sequentialthinking` | 主推理工具 | 执行链式思维推理 |\n| `log_thought` | 记录思考步骤 | 追踪推理过程 |\n| `reset_thinking` | 重置推理状态 | 开始新的推理链 |\n\n### 输入参数\n\n| 参数名 | 类型 | 必填 | 说明 |\n|--------|------|------|------|\n| `query` | string | 是 | 需要推理的问题或任务 |\n| `context` | object | 否 | 额外的上下文信息 |\n| `maxSteps` | number | 否 | 最大推理步骤数 |\n\n### 输出格式\n\n```json\n{\n \"thought\": \"推理思考内容\",\n \"nextStep\": \"下一步推理方向\",\n \"conclusion\": \"阶段性结论\",\n \"metadata\": {\n \"stepNumber\": 1,\n \"totalSteps\": 5\n }\n}\n```\n\n## 环境变量配置\n\n| 变量名 | 默认值 | 说明 |\n|--------|--------|------|\n| `DISABLE_THOUGHT_LOGGING` | `false` | 设置为 `true` 可禁用思考日志 |\n\n## 调试与故障排查\n\n### MCP Inspector 调试\n\n使用 MCP Inspector 可以对服务器进行调试：\n\n```bash\nnpx @modelcontextprotocol/inspector npx -y @modelcontextprotocol/server-sequential-thinking\n```\n\n### 常见问题\n\n**问题：服务器启动超时**\n\n解决方案：确保 Node.js 版本符合要求（Node 22+），并检查网络连接。\n\n**问题：日志记录过多**\n\n解决方案：设置 `DISABLE_THOUGHT_LOGGING=true` 环境变量。\n\n## 许可证\n\nSequential Thinking 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。\n\n资料来源：[src/sequentialthinking/README.md:66-68]()\n\n## 相关资源\n\n- MCP 官方规范：https://modelcontextprotocol.io/specification\n- 服务器源码仓库：https://github.com/modelcontextprotocol/servers\n- 官方文档：https://modelcontextprotocol.io\n\n---\n\n\n\n## Everything 服务器扩展指南\n\n### 相关页面\n\n相关主题：[Everything 服务器架构](#page-3)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/everything/AGENTS.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/AGENTS.md)\n- [src/everything/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/README.md)\n- [src/everything/resources/session.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/resources/session.ts)\n- [src/everything/tools/get-roots-list.ts](https://github.com/modelcontextprotocol/servers/blob/main/src/everything/tools/get-roots-list.ts)\n \n\n# Everything 服务器扩展指南\n\n## 概述\n\nEverything 服务器是 Model Context Protocol (MCP) 生态系统中功能最全面的服务器实现之一，采用 TypeScript 开发，专门设计用于展示 MCP 协议的各项特性。服务器提供工具（Tools）、资源（Resources）和提示（Prompts）三大核心功能模块。\n\n本扩展指南将帮助开发者理解如何在 Everything 服务器中添加新功能、注册工具和资源，以及遵循项目既定的代码规范进行开发。\n\n## 架构设计\n\n### 高层架构\n\nEverything 服务器采用模块化架构设计，核心服务器工厂位于 `src/everything/server/index.ts`，负责在启动时注册所有功能模块并处理连接后的设置。\n\n```\ngraph TD\n A[Server Factory
server/index.ts] --> B[Tools 模块]\n A --> C[Resources 模块]\n A --> D[Prompts 模块]\n A --> E[Transports 模块]\n B --> B1[registerTools]\n C --> C1[registerResources]\n D --> D1[registerPrompts]\n E --> E1[HTTP+SSE Transport]\n E --> E2[Streamable HTTP Transport]\n```\n\n资料来源：[src/everything/AGENTS.md:52-53]()\n\n### 功能模块布局\n\n| 模块 | 路径 | 注册函数 |\n|------|------|----------|\n| 工具 | `src/everything/tools/` | `registerTools(server)` |\n| 资源 | `src/everything/resources/` | `registerResources(server)` |\n| 提示 | `src/everything/prompts/` | `registerPrompts(server)` |\n| 订阅与模拟更新 | `src/everything/resources/subscriptions.ts` | - |\n| 日志辅助 | `src/everything/server/logging.ts` | - |\n| 传输管理 | `src/everything/transports/` | - |\n\n资料来源：[src/everything/AGENTS.md:35-41]()\n\n## 代码风格规范\n\n### 命名约定\n\nEverything 服务器遵循统一的命名规范，确保代码库的一致性和可维护性：\n\n| 类型 | 规范 | 示例 |\n|------|------|------|\n| 变量/函数 | camelCase | `getFileInfo`, `currentRoots` |\n| 类型/类 | PascalCase | `McpServer`, `Resource` |\n| 常量 | UPPER_CASE | `DEFAULT_TIMEOUT` |\n| 文件名及注册项 | kebab-case | `get-annotated-message.ts`, `get-file-info` |\n| 工具名称 | 动词优先 | `get-file-info`（而非 `file-info`） |\n\n资料来源：[src/everything/AGENTS.md:19-23]()\n\n### 文件组织规则\n\n每个功能模块应遵循现有的文件/模块模式，包括：\n- 命名规范\n- 导出结构\n- 注册函数命名（`registerX` 格式）\n\n## 添加新功能\n\n### 扩展工具模块\n\n#### 步骤一：创建工具文件\n\n在 `src/everything/tools/` 目录下创建新的工具文件，使用 kebab-case 命名：\n\n```typescript\n// src/everything/tools/get-roots-list.ts\n\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\n\nexport const registerGetRootsListTool = (server: McpServer) => {\n // 实现工具逻辑\n};\n```\n\n#### 步骤二：导出注册函数\n\n每个工具模块需要导出 `registerX(server)` 函数，用于将新工具注册到 MCP SDK：\n\n```typescript\nexport const registerGetRootsListTool = (server: McpServer) => {\n server.setRequestHandler(\n ListToolsRequestSchema,\n async () => {\n return {\n tools: [\n {\n name: \"get-roots-list\",\n description: \"获取当前 MCP Roots 列表\",\n inputSchema: {\n type: \"object\",\n properties: {},\n },\n },\n ],\n };\n }\n );\n};\n```\n\n资料来源：[src/everything/tools/get-roots-list.ts:1-35]()\n\n#### 步骤三：更新索引文件\n\n将新工具集成到中央索引中，更新 `src/everything/tools/index.ts` 文件。\n\n### 扩展资源模块\n\n#### 资源注册流程\n\n资源模块的注册遵循类似的模式，位于 `src/everything/resources/` 目录：\n\n```typescript\n// 资源注册函数签名\nexport const registerSessionResource = (\n server: McpServer,\n resource: Resource,\n type: \"text\" | \"blob\",\n payload: string\n): ResourceLink => {\n // 1. 解构资源对象\n const { uri, name, mimeType, description, title, annotations, icons, _meta } = resource;\n \n // 2. 准备资源内容\n const resourceContent = type === \"text\" \n ? { uri: uri.toString(), mimeType, text: payload }\n : { uri: uri.toString(), mimeType, blob: payload };\n\n // 3. 检查并移除已存在的同名资源\n const existingResource = registeredResources.get(uri);\n if (existingResource) {\n existingResource.remove();\n registeredResources.delete(uri);\n }\n\n // 4. 注册新资源\n const registeredResource = server.registerResource(\n name,\n uri,\n { mimeType, description, title, annotations, icons, _meta },\n async () => ({\n contents: [resourceContent],\n })\n );\n\n // 5. 追踪已注册资源以便后续移除\n registeredResources.set(uri, registeredResource);\n\n return { type: \"resource_link\", ...resource };\n};\n```\n\n资料来源：[src/everything/resources/session.ts:25-63]()\n\n### 扩展提示模块\n\n提示（Prompts）模块位于 `src/everything/prompts/` 目录，遵循与工具和资源相同的注册模式：\n\n1. 在对应目录下创建新文件\n2. 导出 `registerPrompts(server)` 函数\n3. 更新中央索引 `src/everything/prompts/index.ts`\n\n### 更新中央索引\n\n添加新功能后，必须将新模块连接到中央索引：\n\n| 索引文件 | 需要更新的内容 |\n|----------|----------------|\n| `tools/index.ts` | 导入并注册新工具 |\n| `resources/index.ts` | 导入并注册新资源 |\n| `prompts/index.ts` | 导入并注册新提示 |\n\n资料来源：[src/everything/AGENTS.md:49-51]()\n\n## 工具输入验证\n\n### JSON Schema 要求\n\n所有工具的 inputSchema 必须符合准确的 JSON Schema 规范，并包含有用的描述和示例：\n\n```typescript\ninputSchema: {\n type: \"object\",\n properties: {\n url: {\n type: \"string\",\n description: \"要获取的 URL 地址\",\n examples: [\"https://example.com\"]\n },\n maxLength: {\n type: \"integer\",\n description: \"返回的最大字符数\",\n default: 5000,\n minimum: 1,\n maximum: 1000000\n }\n },\n required: [\"url\"]\n}\n```\n\n资料来源：[src/everything/AGENTS.md:51]()\n\n## 服务器工厂模式\n\n### 初始化流程\n\n`src/everything/server/index.ts` 是服务器的中央入口点，负责：\n\n```mermaid\nsequenceDiagram\n participant Start as 启动服务器\n participant Factory as Server Factory
server/index.ts\n participant Tools as Tools 模块\n participant Resources as Resources 模块\n participant Prompts as Prompts 模块\n \n Start->>Factory: 初始化 McpServer 实例\n Factory->>Tools: registerTools(server)\n Factory->>Resources: registerResources(server)\n Factory->>Prompts: registerPrompts(server)\n Factory->>Factory: 处理连接后设置\n```\n\n## 运行和测试\n\n### 开发模式运行\n\n#### 使用 Streamable HTTP Transport（推荐）\n\n```bash\ncd src/everything\nnpm install\nnpm run start:streamableHttp\n```\n\n#### 使用 HTTP+SSE Transport（已弃用）\n\n```bash\ncd src/everything\nnpm install\nnpm run start:sse\n```\n\n#### 直接运行已安装包\n\n```bash\n# 全局安装\nnpm install -g @modelcontextprotocol/server-everything@latest\n\n# 运行 stdio 服务器\nnpx @modelcontextprotocol/server-everything\n\n# 运行 SSE 服务器\nnpx @modelcontextprotocol/server-everything sse\n\n# 运行 Streamable HTTP 服务器\nnpx @modelcontextprotocol/server-everything streamableHttp\n```\n\n资料来源：[src/everything/README.md:75-98]()\n\n## 项目配置要求\n\n### TypeScript 配置\n\n| 配置项 | 值 |\n|--------|-----|\n| 目标版本 | ES2022 |\n| 模块系统 | Node16 |\n| 模式 | 严格模式 |\n| 测试框架 | vitest + @vitest/coverage-v8 |\n| Node 版本 | 22 |\n\n### 依赖项分组\n\n导入语句应按以下顺序分组：\n\n1. 外部依赖\n2. 内部依赖\n\n```typescript\n// ✅ 正确的导入顺序\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { registerTools } from \"./tools/index.js\";\nimport { registerResources } from \"./resources/index.js\";\n```\n\n## 文档维护\n\n添加或修改重要功能后，必须更新以下文档：\n\n- `src/everything/docs/` 目录下的相关文档\n- `docs/extension.md` - 扩展指南\n- `docs/structure.md` - 项目结构文档\n- `docs/how-it-works.md` - 工作原理文档\n\n资料来源：[src/everything/AGENTS.md:53-54]()\n\n## 总结\n\nEverything 服务器的扩展遵循清晰的设计模式：\n\n1. **遵循命名规范** - camelCase、PascalCase、UPPER_CASE、kebab-case 各有其用\n2. **模块化组织** - 工具、资源、提示各有独立目录\n3. **统一注册函数** - 每个模块导出 `registerX(server)` 格式的注册函数\n4. **中央索引管理** - 通过 index.ts 文件统一管理模块导出\n5. **Schema 验证** - 工具输入必须使用准确的 JSON Schema 并包含描述和示例\n\n---\n\n\n\n## Fetch 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Git 服务器](#page-10)\n\n\n相关源码文件
\n\n以下源码文件用于生成本页说明：\n\n- [src/fetch/pyproject.toml](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/pyproject.toml)\n- [src/fetch/src/mcp_server_fetch/server.py](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/src/mcp_server_fetch/server.py)\n- [src/fetch/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/fetch/README.md)\n- [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)\n- [src/filesystem/README.md](https://github.com/modelcontextprotocol/servers/blob/main/src/filesystem/README.md)\n \n\n# Fetch 服务器\n\nFetch 服务器是 Model Context Protocol (MCP) 生态系统中专注于网页内容获取的服务器实现。它使大语言模型能够检索并处理网页内容，将 HTML 转换为 Markdown 格式，便于模型理解和分析。\n\n资料来源：[src/fetch/README.md:1-15]()\n\n## 核心功能概述\n\nFetch 服务器的核心能力体现在以下方面：\n\n- **网页内容获取**：根据提供的 URL 抓取网页原始内容\n- **HTML 转 Markdown**：自动将 HTML 内容转换为结构化的 Markdown 格式\n- **内容分块读取**：支持通过 `start_index` 参数实现内容的分段获取\n- **灵活配置**：支持自定义 User-Agent、robots.txt 策略和代理设置\n\n资料来源：[src/fetch/README.md:15-30]()\n\n## 架构设计\n\n### 系统组件\n\n```mermaid\ngraph TD\n A[用户/模型] --> B[Fetch 服务器]\n B --> C{请求类型判断}\n C -->|工具调用| D[Model User-Agent]\n C -->|用户提示| E[User-Specified User-Agent]\n D --> F[HTTP 请求]\n E --> F\n F --> G{响应内容类型}\n G -->|HTML| H[Markdown 转换]\n G -->|其他| I[原始内容返回]\n H --> J[内容截断/分页]\n I --> J\n J --> K[返回给调用方]\n```\n\n### 工作流程\n\nFetch 服务器的处理流程遵循以下步骤：\n\n1. 接收请求并解析 URL 和参数\n2. 根据请求来源（工具调用或用户提示）设置 User-Agent\n3. 发起 HTTP 请求获取网页内容\n4. 检测内容类型并执行相应处理\n5. 如为 HTML 且未强制返回原始内容，则转换为 Markdown\n6. 根据 `max_length` 和 `start_index` 进行内容截断\n7. 返回结果给调用方\n\n资料来源：[src/fetch/README.md:45-60]()\n\n## 工具接口\n\n### fetch 工具\n\nFetch 服务器提供单一工具 `fetch`，用于获取网页内容。\n\n资料来源：[src/fetch/README.md:30-45]()\n\n#### 输入参数\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| `url` | string | 是 | - | 要获取的网页 URL |\n| `max_length` | integer | 否 | 5000 | 返回内容的最大字符数 |\n| `start_index` | integer | 否 | 0 | 内容提取的起始字符索引 |\n| `raw` | boolean | 否 | false | 是否返回原始 HTML 内容（不做 Markdown 转换） |\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:70-85]()\n\n#### 参数约束\n\n```python\nclass Fetch(BaseModel):\n \"\"\"Parameters for fetching a URL.\"\"\"\n\n url: Annotated[AnyUrl, Field(description=\"URL to fetch\")]\n max_length: Annotated[\n int,\n Field(\n default=5000,\n description=\"Maximum number of characters to return.\",\n gt=0,\n lt=1000000,\n ),\n ]\n start_index: Annotated[\n int,\n Field(\n default=0,\n description=\"On return output starting at this character index...\",\n ge=0,\n ),\n ]\n raw: Annotated[\n bool,\n Field(\n default=False,\n description=\"Get the actual HTML content of the requested page...\",\n ),\n ]\n```\n\n- `max_length` 必须大于 0 且小于 1000000\n- `start_index` 必须大于等于 0\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:30-55]()\n\n## 服务器配置\n\n### serve 函数参数\n\n```python\nasync def serve(\n custom_user_agent: str | None = None,\n ignore_robots_txt: bool = False,\n proxy_url: str | None = None,\n) -> None:\n \"\"\"Run the fetch MCP server.\n \n Args:\n custom_user_agent: Optional custom User-Agent string\n ignore_robots_txt: Whether to ignore robots.txt restrictions\n proxy_url: Optional proxy URL to use\n \"\"\"\n```\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:90-100]()\n\n### 配置选项总览\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `--user-agent` | string | ModelContextProtocol/1.0 | 自定义 User-Agent |\n| `--ignore-robots-txt` | flag | false | 是否忽略 robots.txt |\n| `--proxy-url` | string | null | 代理服务器地址 |\n\n资料来源：[src/fetch/README.md:60-75]()\n\n## User-Agent 策略\n\nFetch 服务器根据请求来源使用不同的 User-Agent：\n\n| 请求来源 | User-Agent | 说明 |\n|----------|------------|------|\n| 工具调用（通过 MCP 工具） | `ModelContextProtocol/1.0 (Autonomous; +https://github.com/modelcontextprotocol/servers)` | 标识为自主行为 |\n| 用户提示（用户直接请求） | `ModelContextProtocol/1.0 (User-Specified; +https://github.com/modelcontextprotocol/servers)` | 标识为用户指定 |\n\n此设计使目标网站能够区分自动化工具请求和用户直接访问请求。\n\n资料来源：[src/fetch/README.md:55-65]()\n\n## 内容处理逻辑\n\n### HTML 检测\n\n服务器通过以下方式判断响应是否为 HTML：\n\n```python\ncontent_type = response.headers.get(\"content-type\", \"\")\nis_page_html = (\n \" B{是否为 HTML?}\n B -->|是| C{force_raw 参数?}\n B -->|否| D[返回原始内容]\n C -->|是| D\n C -->|否| E[提取并转换为 Markdown]\n E --> F[添加说明前缀]\n D --> G[内容截断处理]\n F --> G\n G --> H[返回结果]\n```\n\n资料来源：[src/fetch/src/mcp_server_fetch/server.py:25-35]()\n\n## 安装与部署\n\n### 安装方式对比\n\n| 安装方式 | 命令 | 适用场景 |\n|----------|------|----------|\n| uvx（推荐） | `uvx mcp-server-fetch` | 快速使用，无需安装 |\n| pip | `pip install mcp-server-fetch` | 持久化安装 |\n| Docker | `docker run -i --rm mcp/fetch` | 隔离环境 |\n\n资料来源：[src/fetch/README.md:70-90]()\n\n### Claude Desktop 配置\n\n\nuvx 配置
\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"]\n }\n }\n}\n```\n \n\n\nDocker 配置
\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"mcp/fetch\"]\n }\n }\n}\n```\n \n\n\npip 配置
\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_fetch\"]\n }\n }\n}\n```\n \n\n资料来源：[src/fetch/README.md:90-125]()\n\n### Windows 特殊配置\n\n在 Windows 系统上，建议设置 `PYTHONIOENCODING` 环境变量以避免字符编码问题导致的超时：\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-fetch\"],\n \"env\": {\n \"PYTHONIOENCODING\": \"utf-8\"\n }\n }\n }\n}\n```\n\n资料来源：[src/fetch/README.md:40-50]()\n\n## 调试与开发\n\n### MCP Inspector\n\n使用 MCP Inspector 可以调试服务器：\n\n```bash\n# uvx 安装\nnpx @modelcontextprotocol/inspector uvx mcp-server-fetch\n\n# 源码调试\ncd path/to/servers/src/fetch\nnpx @modelcontextprotocol/inspector uv run mcp-server-fetch\n```\n\n资料来源：[src/fetch/README.md:55-65]()\n\n### 可选依赖\n\n安装 Node.js 后，Fetch 服务器会使用更强大的 HTML 简化库：\n\n> Optionally: Install node.js, this will cause the fetch server to use a different HTML simplifier that is more robust.\n\n资料来源：[src/fetch/README.md:70-75]()\n\n## 安全考量\n\n### 风险警告\n\n> [!CAUTION]\n> 此服务器可以访问本地/内部 IP 地址，可能存在安全风险。使用此 MCP 服务器时需谨慎，确保不会暴露敏感数据。\n\n资料来源：[src/fetch/README.md:15-20]()\n\n### 安全机制\n\n- **robots.txt 遵循**：默认遵守目标网站的 robots.txt 规则\n- **User-Agent 标识**：明确标识为自动化工具，便于网站识别和限制\n- **目录访问控制**：与 filesystem 服务器不同，fetch 服务器不限制访问路径\n\n资料来源：[src/fetch/README.md:20-30]()\n\n## 与其他 MCP 服务器的关系\n\nFetch 服务器是 MCP 服务器生态的一部分，与其他服务器的协作模式如下：\n\n```mermaid\ngraph LR\n A[文件系统服务器] -->|提供本地文件操作| B[Claude/模型]\n C[Fetch 服务器] -->|提供网络内容获取| B\n D[Memory 服务器] -->|提供持久化存储| B\n E[Time 服务器] -->|提供时间信息| B\n```\n\n资料来源：[src/filesystem/README.md:1-20]()\n\n## 项目规范\n\n根据项目规范，Fetch 服务器遵循以下标准：\n\n- **Python 版本**：>= 3.10\n- **类型检查**：pyright\n- **代码风格**：ruff\n- **包管理**：uv（使用 uv sync 和 uv run）\n- **测试框架**：pytest-asyncio（异步测试）\n\n资料来源：[CLAUDE.md:20-40]()\n\n## 贡献指南\n\n项目欢迎对 Fetch 服务器的贡献：\n\n- 错误修复\n- 可用性改进\n- MCP 协议特性演示（Resources、Prompts、Roots）\n\n贡献方式请参考项目根目录的 [CLAUDE.md](https://github.com/modelcontextprotocol/servers/blob/main/CLAUDE.md)。\n\n资料来源：[CLAUDE.md:45-55]()\n\n---\n\n\n\n## Git 服务器\n\n### 相关页面\n\n相关主题：[项目简介](#page-1), [Fetch 服务器](#page-9)\n\n根据提供的上下文，我无法生成关于 Git 服务器的完整技术文档，因为所提供的内容中**不包含 Git 服务器的源码文件**。\n\n## 可用的源码文件\n\n在提供的上下文中，我仅找到以下源码文件：\n\n| 文件路径 | 说明 |\n|---------|------|\n| src/fetch/README.md | Fetch 服务器文档 |\n| src/sequentialthinking/README.md | 顺序思考服务器文档 |\n| src/time/README.md | 时间服务器文档 |\n| src/filesystem/README.md | 文件系统服务器文档 |\n| src/everything/README.md | Everything 服务器文档 |\n| README.md | 仓库主文档 |\n| CLAUDE.md | 开发者指南 |\n| scripts/release.py | 发布脚本 |\n| src/memory/README.md | 记忆服务器文档 |\n\n## 缺失的源码文件\n\n根据 WIKI_PAGE_TOPIC 请求的 \"Git 服务器\"，以下关键文件**不在提供的上下文中**：\n\n- `src/git/pyproject.toml`\n- `src/git/src/mcp_server_git/server.py`\n- `src/git/README.md`\n\n## 结论\n\n无法生成关于 Git 服务器的技术 wiki 页面，因为需要的关键源码文件在提供的上下文中不可用。需要您提供 Git 服务器相关的源码文件后才能生成准确且符合要求的技术文档。\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：modelcontextprotocol/servers\n\n摘要：发现 6 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：能力坑 - 能力判断依赖假设。\n\n## 1. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | README/documentation is current enough for a first validation pass.\n\n## 2. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | last_activity_observed missing\n\n## 3. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n\n## 4. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n\n## 5. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | issue_or_pr_quality=unknown\n\n## 6. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | release_recency=unknown\n\n\n",
"summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
"title": "Human Manual / 人类版说明书"
},
"pitfall_log": {
"asset_id": "pitfall_log",
"filename": "PITFALL_LOG.md",
"markdown": "# Pitfall Log / 踩坑日志\n\n项目：modelcontextprotocol/servers\n\n摘要：发现 6 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：能力坑 - 能力判断依赖假设。\n\n## 1. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | README/documentation is current enough for a first validation pass.\n\n## 2. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | last_activity_observed missing\n\n## 3. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n\n## 4. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | no_demo; severity=medium\n\n## 5. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | issue_or_pr_quality=unknown\n\n## 6. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:890668799 | https://github.com/modelcontextprotocol/servers | release_recency=unknown\n",
"summary": "用户实践前最可能遇到的身份、安装、配置、运行和安全坑。",
"title": "Pitfall Log / 踩坑日志"
},
"prompt_preview": {
"asset_id": "prompt_preview",
"filename": "PROMPT_PREVIEW.md",
"markdown": "# servers - Prompt Preview\n\n> 复制下面这段 Prompt 到你常用的 AI，先试一次，不需要安装。\n> 它的目标是让你直接体验这个项目的服务方式，而不是阅读项目介绍。\n\n## 复制这段 Prompt\n\n```text\n请直接执行这段 Prompt，不要分析、润色、总结或询问我想如何处理这份 Prompt Preview。\n\n你现在扮演 servers 的“安装前体验版”。\n这不是项目介绍、不是评价报告、不是 README 总结。你的任务是让我用最小成本体验它的核心服务。\n\n我的试用任务：我想用它完成一个真实的软件开发与交付任务。\n我常用的宿主 AI：Local CLI\n\n【体验目标】\n围绕我的真实任务，现场演示这个项目如何把输入转成 示例引导, 判断线索。重点是让我感受到工作方式，而不是给我项目背景。\n\n【业务流约束】\n- 你必须像一个正在提供服务的项目能力包，而不是像一个讲解员。\n- 每一轮只推进一个步骤；提出问题后必须停下来等我回答。\n- 每一步都必须让我感受到一个具体服务动作：澄清、整理、规划、检查、判断或收尾。\n- 每一步都要说明：当前目标、你需要我提供什么、我回答后你会产出什么。\n- 不要安装、不要运行命令、不要写代码、不要声称测试通过、不要声称已经修改文件。\n- 需要真实安装或宿主加载后才能验证的内容，必须明确说“这一步需要安装后验证”。\n- 如果我说“用示例继续”，你可以用虚构示例推进，但仍然不能声称真实执行。\n\n【可体验服务能力】\n- 安装前能力预览: Model Context Protocol Servers 输入：用户任务, 当前 AI 对话上下文；输出：示例引导, 判断线索。\n\n【必须安装后才可验证的能力】\n- 命令行启动或安装流程: 项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 输入：终端环境, 包管理器, 项目依赖；输出：安装结果, 列表/更新/运行结果。\n\n【核心服务流】\n请严格按这个顺序带我体验。不要一次性输出完整流程：\n1. page-1：项目简介。围绕“项目简介”模拟一次用户任务，不展示安装或运行结果。\n2. page-2：仓库结构与构建系统。围绕“仓库结构与构建系统”模拟一次用户任务，不展示安装或运行结果。\n3. page-3：Everything 服务器架构。围绕“Everything 服务器架构”模拟一次用户任务，不展示安装或运行结果。\n4. page-5：Filesystem 服务器。围绕“Filesystem 服务器”模拟一次用户任务，不展示安装或运行结果。\n\n【核心能力体验剧本】\n每一步都必须按“输入 -> 服务动作 -> 中间产物”执行。不要只说流程名：\n1. page-1\n输入：用户提供的“项目简介”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n2. page-2\n输入：用户提供的“仓库结构与构建系统”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n3. page-3\n输入：用户提供的“Everything 服务器架构”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n4. page-5\n输入：用户提供的“Filesystem 服务器”相关信息。\n服务动作：模拟项目在这一步的核心判断和整理方式。\n中间产物：一个可检查的小结果。\n\n【项目服务规则】\n这些规则决定你如何服务用户。不要解释规则本身，而要在每一步执行时遵守：\n- 先确认用户任务、输入材料和成功标准，再模拟项目能力。\n- 每一步都必须形成可检查的小产物，并等待用户确认后再继续。\n- 凡是需要安装、调用工具或访问外部服务的能力，都必须标记为安装后验证。\n\n【每一步的服务约束】\n- Step 1 / page-1：Step 1 必须围绕“项目简介”形成一个小中间产物，并等待用户确认。\n- Step 2 / page-2：Step 2 必须围绕“仓库结构与构建系统”形成一个小中间产物，并等待用户确认。\n- Step 3 / page-3：Step 3 必须围绕“Everything 服务器架构”形成一个小中间产物，并等待用户确认。\n- Step 4 / page-5：Step 4 必须围绕“Filesystem 服务器”形成一个小中间产物，并等待用户确认。\n\n【边界与风险】\n- 不要声称已经安装、运行、调用 API、读写本地文件或完成真实任务。\n- 安装前预览只能展示工作方式，不能证明兼容性、性能或输出质量。\n- 涉及安装、插件加载、工具调用或外部服务的能力必须安装后验证。\n\n【可追溯依据】\n这些路径只用于你内部校验或在我追问“依据是什么”时简要引用。不要在首次回复主动展开：\n- https://github.com/modelcontextprotocol/servers\n- https://github.com/modelcontextprotocol/servers#readme\n- README.md\n- package.json\n- CLAUDE.md\n- tsconfig.json\n- scripts/release.py\n- src/everything/server/index.ts\n- src/everything/README.md\n- src/everything/docs/architecture.md\n- src/everything/docs/structure.md\n- src/everything/docs/features.md\n\n【首次问题规则】\n- 首次三问必须先确认用户目标、成功标准和边界，不要提前进入工具、安装或实现细节。\n- 如果后续需要技术条件、文件路径或运行环境，必须等用户确认目标后再追问。\n\n首次回复必须只输出下面 4 个部分：\n1. 体验开始：用 1 句话说明你将带我体验 servers 的核心服务。\n2. 当前步骤：明确进入 Step 1，并说明这一步要解决什么。\n3. 你会如何服务我：说明你会先改变我完成任务的哪个动作。\n4. 只问我 3 个问题，然后停下等待回答。\n\n首次回复禁止输出：后续完整流程、证据清单、安装命令、项目评价、营销文案、已经安装或运行的说法。\n\nStep 1 / brainstorming 的二轮协议：\n- 我回答首次三问后，你仍然停留在 Step 1 / brainstorming，不要进入 Step 2。\n- 第二次回复必须产出 6 个部分：澄清后的任务定义、成功标准、边界条件、\n 2-3 个可选方案、每个方案的权衡、推荐方案。\n- 第二次回复最后必须问我是否确认推荐方案；只有我明确确认后，才能进入下一步。\n- 第二次回复禁止输出 git worktree、代码计划、测试文件、命令或真实执行结果。\n\n后续对话规则：\n- 我回答后，你先完成当前步骤的中间产物并等待确认；只有我确认后，才能进入下一步。\n- 每一步都要生成一个小的中间产物，例如澄清后的目标、计划草案、测试意图、验证清单或继续/停止判断。\n- 所有演示都写成“我会建议/我会引导/这一步会形成”，不要写成已经真实执行。\n- 不要声称已经测试通过、文件已修改、命令已运行或结果已产生。\n- 如果某个能力必须安装后验证，请直接说“这一步需要安装后验证”。\n- 如果证据不足，请明确说“证据不足”，不要补事实。\n```\n",
"summary": "不安装项目也能感受能力节奏的安全试用 Prompt。",
"title": "Prompt Preview / 安装前试用 Prompt"
},
"quick_start": {
"asset_id": "quick_start",
"filename": "QUICK_START.md",
"markdown": "# Quick Start / 官方入口\n\n项目：modelcontextprotocol/servers\n\n## 官方安装入口\n\n### Node.js / npx · 官方安装入口\n\n```bash\nnpx -y @modelcontextprotocol/server-memory\n```\n\n来源：https://github.com/modelcontextprotocol/servers#readme\n\n## 来源\n\n- repo: https://github.com/modelcontextprotocol/servers\n- docs: https://github.com/modelcontextprotocol/servers#readme\n",
"summary": "从项目官方 README 或安装文档提取的开工入口。",
"title": "Quick Start / 官方入口"
}
},
"validation_id": "dval_e719397ea4654b7d9aa9c05ded209583"
}