MCP Examples

cd docs-server

# Install dependencies
npm install

# Build
npm run build

# Test with MCP Inspector (interactive browser UI)
npx @modelcontextprotocol/inspector node dist/index.js

# Or run directly via Claude Code
claude mcp add docs-server -- node /path/to/docs-server/dist/index.js

server.tool(
  "search_docs",
  "Search internal documentation by keyword",
  { query: z.string().min(1).describe("Search query"), limit: z.number().int().min(1).max(50).default(10) },
  async ({ query, limit }) => {
    const results = documents.filter(d => d.body.toLowerCase().includes(query.toLowerCase())).slice(0, limit);
    return { content: [{ type: "text", text: JSON.stringify(results) }] };
  }
);

server.resource("docs://index", "List all documents", async (uri) => ({
  contents: [{ uri: uri.href, text: JSON.stringify(documents.map(d => ({ id: d.id, title: d.title }))) }]
}));

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

// Transport must be created inside the /sse handler
app.get("/sse", async (req, res) => {
  const transport = new SSEServerTransport("/message", res);
  transports.set(transport.sessionId, transport);
  await server.connect(transport);
});
app.post("/message", async (req, res) => {
  const transport = transports.get(req.query.sessionId as string);
  await transport?.handlePostMessage(req, res);
});

// Elasticsearch
const results = await esClient.search({ index: "docs", query: { match: { body: query } } });

// Postgres full-text search
const results = await db.query("SELECT * FROM docs WHERE to_tsvector(body) @@ plainto_tsquery($1)", [query]);