FindOneRecord
Locate a specific record in RushDB's graph database by applying search criteria and label filters to retrieve matching data.
Instructions
Find a single record that matches the given search criteria
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| labels | No | Filter by record labels | |
| where | No | Search conditions for finding the record |
Implementation Reference
- tools/FindOneRecord.ts:17-26 (handler)Core handler function that executes the FindOneRecord tool: queries the database for a single record matching the provided labels and where conditions.
export async function FindOneRecord(params: { labels?: string[]; where?: Record<string, any> }) { const { labels, where } = params const result = await db.records.findOne({ ...(labels && { labels }), ...(where && { where }) }) return result?.data || null } - tools.ts:336-346 (registration)Tool registration entry in the tools array, providing name, description, and input schema for MCP server.listTools().
name: 'FindOneRecord', description: 'Find a single record that matches the given search criteria', inputSchema: { type: 'object', properties: { labels: { type: 'array', items: { type: 'string' }, description: 'Filter by record labels' }, where: { type: 'object', description: 'Search conditions for finding the record' } }, required: [] } }, - tools.ts:338-346 (schema)Input schema definition for validating FindOneRecord tool parameters.
inputSchema: { type: 'object', properties: { labels: { type: 'array', items: { type: 'string' }, description: 'Filter by record labels' }, where: { type: 'object', description: 'Search conditions for finding the record' } }, required: [] } }, - index.ts:368-380 (handler)MCP CallToolRequest dispatcher case that invokes the FindOneRecord handler and formats the response content.
case 'FindOneRecord': const foundOneRecord = await FindOneRecord({ labels: args.labels as string[] | undefined, where: args.where as Record<string, any> | undefined }) return { content: [ { type: 'text', text: foundOneRecord ? JSON.stringify(foundOneRecord, null, 2) : 'No matching record found.' } ] } - index.ts:72-76 (registration)Registers the listTools capability, returning the tools array which includes FindOneRecord.
server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools } })