AI导哈

VS Code MCP配置工具

用于配置VS Code与Tenx MCP服务器集成的工具，提供规则文件优化和代理行为控制功能。

  • by Birkity
  • 云端部署
  • 更新于
在 GitHub 查看 Birkity/MCP_Setup_TRP1_Assesment

使用说明

10 Academy MCP Setup Challenge – Task 3: Documentation Report

Author: Birkity Yishak  |  Date: February 02, 2026

Challenge Goal: Configure VS Code with Tenx MCP server, improve agent rules file based on best practices, and document the process.

概述

我遵循了提供的VS Code设置指南，研究了社区最佳实践（特别是Boris Cherny的工作流程），更新了规则文件，并花了大量时间排除了持续的MCP连接故障。尽管连接没有完全工作，但我完成了所有其他要求，并透明地记录了我的工作。

1.我所做的–逐步操作和对规则文件的更改

初始设置（VS代码和MCP）

  • 将VS代码更新为最新版本
  • 已安装GitHub Copilot+GitHub Copilot聊天扩展
  • 创建 .github/copilot-instructions.md （质疑中提供的初始规则文件）
  • 创建 .vscode/mcp.json 并按照指示添加了Tenx服务器配置
  • 添加 .github/chatmodes/4.1-Beast.chatmode.md （“4.1 Beast”聊天模式）：此文件使用GPT-4.1作为顶级编码代理为Copilot配置自定义聊天模式。
{
  "servers": {
    "tenxfeedbackanalytics": {
      "url": "https://mcppulse.10academy.org/proxy",
      "type": "http",
      "headers": {
        "X-Device": "windows",
        "X-Coding-Tool": "vscode"
      }
    }
  },
  "inputs": []
}
  • 已启动服务器→ 通过浏览器中的GitHub重定向进行身份验证→ 服务器显示 “跑步” 在工具列表中

最佳实践研究

  • 阅读Boris Cherny关于X的工作流线程和相关文章：专注于“舰队命令”风格、共享内存（相当于CLAUDE.md）、计划优先、错误日志记录、并行代理

规则文件改进（.github/copilot指令.md）

  • 保留原始强制触发规则(log_passage_time_trigger, log_performance_outlier_trigger)顶部不变
  • 添加了受研究启发的新章节：
    • 核心原则： 舰队指挥官心态、准确性高于速度、氛围与生产编码
    • 每个任务的工作流程： 强制规划模式优先，寻求批准，分解和并行化任务，总结上下文
    • 错误处理和学习： 分析错误，在“经验教训”部分添加永久修复，以防止重复
    • 编码样式对齐： PEP8，简洁的名称，逻辑注释
    • 测试和迭代： 测试规则随示例任务而变化
  • 迭代两次：第一个版本强调计划；第二附加反射误差段

测试尝试

  • 在Copilot聊天中切换到代理模式
  • 发送测试提示（例如，工作区摘要）
  • 工具列表、MCP状态和日志的截图

2.成功的部分

  • MCP配置准确：MCP.json语法正确，headers设置正确，多次成功完成GitHub身份验证→ 服务器始终显示 “跑步” 状态。
  • 工具面板显示内置工具（执行、读取、搜索等），并尝试包含Tenx工具。
  • 规则研究是有效的：Boris Cherny的模式（规划优先、共享记忆、经验教训）清晰地整合了概念上改进的代理行为（例如，将加强结构并防止重复错误）。
  • 故障排除规程：捕获详细的日志、屏幕截图和步骤——这是努力和系统调试的有力证据。

3.什么不起作用——面临的挑战和故障排除步骤

主要挑战（持续且未解决）：
Tenx MCP服务器从未完全初始化→ 副驾驶代理模式仍停留在“正在工作…”，没有响应。

观察到的具体错误（来自GitHub Copilot输出日志）：

  • 404关于标准OAuth元数据发现：
    Error fetching resource metadata from https://mcppulse.10academy.org/.well-known/oauth-protected-resource: 404 Not Found
    → 回落到非标准 /proxy 路径，但可能导致验证问题。
  • 严重SSE故障：
    Error reading SSE stream: TypeError: t.body.getReader is not a function
    → 响应体不是可读流→ 无法读取SSE流→ 没有建立通信信道。
  • 无限循环：
    Waiting for server to respond to 'initialize' request... 每5秒重复一次。

我采取的详细故障排除步骤：

  1. 停止并重新启动Tenx服务器8次以上；每次都通过GitHub重新验证。
  2. 禁用Pylance MCP服务器和所有非必要工具（GitKraken、容器工具）以消除冲突。
  3. 每次重大更改后重新加载VS代码窗口（Ctrl+R）。
  4. 添加 "Accept": "text/event-stream" mcp.json的头部→ 没有改善。
  5. 创建了一个新的空工作区→ 仅复制了mcp.json→ 在那里测试（行为相同）。
  6. 在VS Code中注销/登录GitHub帐户。
  7. 更新了所有扩展名和VS代码本身。
  8. 检查网络：浏览器可以访问 https://mcppulse.10academy.org/proxy （返回404/空白，无超时）。
  9. 反复分析输出日志→ 将SSE TypeError确定为根本原因（在VS Code MCP代理问题中很常见，例如围绕Envoy/NGINX代理的GitHub问题讨论）。

关于挑战的结论：
几乎可以肯定，故障发生在Tenx代理端（非标准元数据路径+损坏的SSE支持），而不是我的本地设置。尽管如此，服务器仍显示为“正在运行”，我在提交过程中保持其活动状态。

4.获得的见解——规则如何改变代理人的行为

  • 对齐与控制：规则将代理从通用响应者转换为结构化协作者。强制性计划首先符合我的思维过程（高层指导→ 详细的执行），减少来回和微观管理。
  • 错误预防和演变“经验教训”部分创建了机构记忆——代理人从错误中永久学习，更好地与长期期望保持一致（随着时间的推移，准确性会逐渐提高）。
  • 个性化：嵌入样式偏好（PEP8、注释）使输出感觉与我的编码习惯很自然。
  • 总体影响：好的规则将人工智能转化为意图的延伸，而不是一个独立的实体。研究表明，社区共识：从强大的结构（规划、触发）开始，根据观察到的行为进行迭代。即使没有现场测试，经过概念应用验证的规则也能显著提高可预测性和实用性。

存储库中的摘要和工件

  • 最终规则文件： .github/copilot-instructions.md
  • 本报告： README..md
  • 支持文件：屏幕截图（工具列表、MCP状态、MCP.json）、显示错误的完整输出日志
  • 研究笔记：鲍里斯·切尔尼的见解简述

谢谢你给我这个机会。

相关 MCP