JW MCP Server

Instructions

Implementation Reference

• src/tools/scripture-tools.js:20-38 (schema)

  Defines the tool schema including name, description, and input validation schema for the search_bible_books tool.
  export const searchBibleBooksTool = { name: 'search_bible_books', description: 'Search for Bible books by name or abbreviation. Returns book numbers (1-66) and names. Useful for finding the correct book number for other scripture tools. Examples: "matt" -> Matthew (40), "1 john" -> 1 John (62), "gen" -> Genesis (1).', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'Search query - can be book name, abbreviation, or number. Examples: "matthew", "matt", "mt", "40", "1 john"' }, limit: { type: 'number', description: 'Maximum number of results to return (default: 10)', default: 10 } }, required: ['query'] } };
• src/tools/scripture-tools.js:40-91 (handler)

  The primary handler function that implements the search_bible_books tool. Validates input, calls searchBooks helper, formats results with testament info, and returns JSON or error messages.
  export async function searchBibleBooksImplementation(query, limit = 10) { try { if (!query || typeof query !== 'string') { return { content: [{ type: 'text', text: 'Error: Query must be a non-empty string' }], isError: true }; } const results = searchBooks(query, limit); if (results.length === 0) { return { content: [{ type: 'text', text: `No Bible books found matching "${query}". Try using a book name, abbreviation, or number (1-66).` }] }; } // Format results const formattedResults = results.map(r => ({ number: r.number, name: r.name, testament: r.number <= 39 ? 'Old Testament' : 'New Testament', relevance_score: r.score })); return { content: [{ type: 'text', text: JSON.stringify({ query: query, results_count: formattedResults.length, books: formattedResults }, null, 2) }] }; } catch (error) { return { content: [{ type: 'text', text: `Error searching Bible books: ${error.message}` }], isError: true }; } }
• src/tools/bible-books.js:150-218 (helper)

  Supporting utility function that performs fuzzy search on Bible book names and abbreviations, calculates relevance scores, sorts results, and limits output. Called by the main handler.
  export function searchBooks(query, limit = 10) { if (!query || typeof query !== 'string') { return []; } const normalizedQuery = query.toLowerCase().trim(); // If query is a number, return exact match const asNumber = parseInt(normalizedQuery); if (!isNaN(asNumber) && asNumber >= 1 && asNumber <= 66) { return [{ number: asNumber, name: BIBLE_BOOKS[asNumber], score: 100 }]; } const results = []; // Search through all books for (const [num, name] of Object.entries(BIBLE_BOOKS)) { const bookNum = parseInt(num); const nameLower = name.toLowerCase(); let score = 0; // Exact match if (nameLower === normalizedQuery) { score = 100; } // Starts with query else if (nameLower.startsWith(normalizedQuery)) { score = 80; } // Contains query else if (nameLower.includes(normalizedQuery)) { score = 60; } // Check if any word starts with query else if (nameLower.split(' ').some(word => word.startsWith(normalizedQuery))) { score = 70; } // Also check abbreviations for (const [abbr, abbNum] of Object.entries(BOOK_ABBREVIATIONS)) { if (abbNum === bookNum && abbr.startsWith(normalizedQuery)) { score = Math.max(score, 75); } } if (score > 0) { results.push({ number: bookNum, name: name, score: score }); } } // Sort by score (highest first), then by book number results.sort((a, b) => { if (b.score !== a.score) { return b.score - a.score; } return a.number - b.number; }); return results.slice(0, limit); }
• src/index.js:52-56 (registration)

  Registers the search_bible_books tool (included in allTools) for the stdio MCP server by handling ListToolsRequestSchema.
  server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: allTools, }; });
• src/http-server.js:65-69 (registration)

  Registers the search_bible_books tool (included in allTools) for the HTTP MCP server by handling ListToolsRequestSchema.
  server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: allTools, }; });