FastMCP文档MCP服务器(VS代码扩展)
在VS Code中将FastMCP文档+项目上下文无缝地暴露给启用MCP的LLM代理。
______________________________________________________________________
✅ 此扩展功能是什么
此扩展自动注册远程 FastMCP文档MCP服务器 在你的 工作区 和 用户 mcp.json 因此LLM代理(通过MCP主机扩展)可以查询FastMCP文档和(取决于您的服务器实现)项目资源。它简化了首次运行设置,提供了一个状态栏指示器,并让您快速访问配置文件。
______________________________________________________________________
✨ 特性
| 能力 | 描述 |
|---|---|
| 自动注册 | 将服务器添加到工作区 .vscode/mcp.json 用户级别 mcp.json. |
| 首次运行入职培训 | 欢迎页面+可选自动打开配置文件。 |
| 状态栏指示器 | 显示FastMCP+工具计数(单击打开用户配置)。 |
| 一键命令 | FastMCP: Add FastMCP Context Server 注册/重新注册。 |
| 可配置 | 禁用自动打开和隐藏/移动状态栏项的设置。 |
| 远程HTTP服务器 | 使用您部署的 https://abcstark-server.fastmcp.app/mcp 终点。 |
______________________________________________________________________
🚀 安装
- 从安装 VS市场 或加载VSIX。
- 如果系统提示,请重新加载VS代码。
- 首次激活时,会出现欢迎屏幕。点击 添加FastMCP上下文服务器 (或运行下面的命令)。
- (可选)随时通过命令面板重新打开欢迎。
打开命令面板
雨衣: ⌘⇧P |Windows/Linux: Ctrl+Shift+P
然后键入命令标题的一部分(例如“FastMCP”),然后按Enter键。
FastMCP: Add FastMCP Context Server
FastMCP: Show FastMCP Welcome
FastMCP: Open User MCP Configuration
FastMCP: [DEV] Reset FastMCP Onboarding State______________________________________________________________________
🧠 在聊天中使用FastMCP文档工具
服务器注册后,启用MCP的聊天UI会显示一个FastMCP文档工具(确切标签各不相同)。如果支持内联工具标签,您可以直接将其引用为 #fastmcp_docs .
快速示例
Use #fastmcp_docs and summarize FastMCP authentication.
Use #fastmcp_docs to list getting-started topics.
Compare FastMCP auth vs generic MCP auth (use #fastmcp_docs ).
Explain required headers/tokens (use #fastmcp_docs ).如果标签表单没有触发工具调用,可以说:“调用FastMCP文档工具并解释身份验证。”
| 需要 | 提示 |
|---|---|
| Auth 详情 | Use #fastmcp_docs and outline auth requirements. |
| 配置帮助 | Use #fastmcp_docs and show an example mcp.json block. |
| 主题列表 | Use #fastmcp_docs and list available sections. |
麻烦?重新运行Add Server命令,然后重新启动服务器(该命令会自动执行此操作)。更多提示请参阅下面的故障排除。
______________________________________________________________________
🛠 命令(调色板标题和ID)
| 标题(调色板) | 命令ID | 目的 |
|---|---|---|
| 添加FastMCP上下文服务器 | fastmcpContext.addServer | 写入/更新 mcp.json +(重新)开始。 |
| 显示FastMCP欢迎 | fastmcpContext.showWelcome | 重新打开入职Web视图。 |
| 打开用户MCP配置 | fastmcpContext.openUserMcpConfig | 打开用户级别 mcp.json. |
| \[DEV\]重置FastMCP板载状态 | fastmcpContext.resetOnboarding | 清除首次运行标志(之后重新加载)。 |
______________________________________________________________________
⚙️ 设置
| 设置 | 默认值 | 说明 |
|---|---|---|
fastmcpContext.openConfigOnFirstInstall | true | 首次安装后打开创建/更新的配置文件。 |
fastmcpContext.statusBar.show | true | 显示FastMCP状态栏项。 |
fastmcpContext.statusBar.alignmentRight | false | 将状态栏项目向右对齐。 |
______________________________________________________________________
📄 示例 mcp.json
{
"servers": {
"fastmcp-documentation-resource": {
"url": "https://abcstark-server.fastmcp.app/mcp",
"type": "http"
}
},
"inputs": []
}______________________________________________________________________
🔍 验证安装
- 打开
.vscode/mcp.json(工作区)并确认服务器条目存在。 - 打开 MCP输出 面板:确保您看到
Connection state: Running以及工具发现消息。 - 单击状态栏项(全球图标)打开用户级配置。
______________________________________________________________________
🧪 故障排除
| 症状 | 修复 |
|---|---|
服务器保持不变 Starting | 检查URL的网络访问权限,使用进行测试 curl. |
| 工具计数未显示 | MCP主机可能不支持 mcp.servers.listTools -这是最好的努力。是啊。 |
| 配置未打开 | 禁用/启用设置或运行 FastMCP: Open User MCP Configuration. |
| 重复条目 | 再次运行Add命令;它安全地覆盖URL条目。 |
______________________________________________________________________
📚 资源
______________________________________________________________________
🗒 发行说明(摘要)
查看完整历史记录 更改日志.md.
1.3.0
- 添加了状态栏项(工具计数+快速配置访问)。
- 添加了命令和设置(打开用户配置、可配置的自动打开和状态栏对齐)。
1.2.0
- 自动打开
mcp.json首次注册后。
1.1.0
- 文件完善;描述更新。
1.0.0
- 初始入职流程和欢迎页面。
______________________________________________________________________
作者 abcSTARK\ 许可证: 麻省理工学院
______________________________________________________________________
喜欢吗?考虑在回购中加入主角,以支持未来的增强功能。
