MCP 排错手册：高频故障的定位与根因修复

// mcp-server.ts —— @modelcontextprotocol/sdk ^1.0 stdio 只读 Server
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = new McpServer({ name: 'docs-readonly', version: '1.0.0' });
server.tool('read_doc', { path: schema.string() }, async ({ path }) => {
  // scope 最小化到只读，绝不暴露写权限或全文件系统
  return { content: [{ type: 'text', text: readAllowed(path) }] };
});

const transport = new StdioServerTransport();
await server.connect(transport);

// 客户端在 claude_desktop_config.json 登记：
// "mcpServers": { "docs": { "command": "node", "args": ["mcp-server.ts"] } } }