怎么开发一个 MCP Server？

import { readdir, readFile } from 'node:fs/promises'
import path from 'node:path'
import { McpServer } from '@modelcontextprotocol/server'
import { serveStdio } from '@modelcontextprotocol/server/stdio'
import { z } from 'zod'

// 笔记目录通过命令行参数传入：node build/index.js /path/to/notes
const dirArg = process.argv[2]
if (!dirArg) {
  console.error('用法：node build/index.js <笔记目录>')
  process.exit(1)
}
const NOTES_DIR = path.resolve(dirArg)

// 工厂函数：serveStdio 为每个连接调用它，创建一个 Server 实例
function createServer() {
  const server = new McpServer({ name: 'notes', version: '1.0.0' })

  server.registerTool(
    'search_notes',
    {
      title: '搜索笔记',
      description:
        '在用户的本地 Markdown 笔记里按关键词搜索，返回匹配的文件名和所在行。用户提到"我的笔记""之前记过"时使用。只能搜索，不能修改笔记。',
      inputSchema: z.object({
        keyword: z.string().min(1).describe('要搜索的关键词，区分大小写'),
        limit: z.number().int().min(1).max(20).optional().describe('最多返回几条，默认 5'),
      }),
      annotations: { readOnlyHint: true },
    },
    async ({ keyword, limit }) => {
      const max = limit ?? 5
      const files = (await readdir(NOTES_DIR)).filter((f) => f.endsWith('.md'))
      const hits: string[] = []
      for (const file of files) {
        if (hits.length >= max) break
        const text = await readFile(path.join(NOTES_DIR, file), 'utf8')
        const line = text.split('\n').find((l) => l.includes(keyword))
        if (line) hits.push(`${file}：${line.trim()}`)
      }
      return {
        content: [{ type: 'text', text: hits.length ? hits.join('\n') : `没有找到包含"${keyword}"的笔记` }],
      }
    },
  )
  return server
}

serveStdio(createServer)
console.error(`notes server 已启动，笔记目录：${NOTES_DIR}`) // 日志写 stderr

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/notes-server/build/index.js", "/Users/me/notes"]
    }
  }
}

npm run build
# 打开网页界面，可以查看工具列表、填参数调用、查看收发的 JSON-RPC 消息
npx @modelcontextprotocol/inspector node build/index.js ~/notes
# 命令行模式，适合写进脚本
npx @modelcontextprotocol/inspector --cli node build/index.js ~/notes --method tools/list