feat: add tools to interact with the app

[sudharsan-selvaraj]

No description provided.

[Copilot]

Pull Request Overview

Adds a suite of Appium interaction tools and integrates them into the MCP server, updates locator logic to return a single suggestion, and stubs out ID validation.

• Introduces appium_find_element, appium_click, appium_set_value, appium_get_text, and appium_screenshot tools
• Registers new tools (and a test generation helper) in src/tools/index.ts
• Updates locator generator to return only the top suggestion and adds a placeholder ID checker

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/utils.ts	Stubbed out checkIsValidElementId with always-true
src/tools/interactions/click.ts	Adds click tool; function name mismatches export
src/tools/interactions/setValue.ts	Adds set-value tool
src/tools/interactions/getText.ts	Adds get-text tool
src/tools/interactions/screenshot.ts	Adds screenshot tool without parameters schema
src/tools/interactions/find.ts	Adds find-element tool
src/tools/index.ts	Registers all new tools
src/tools/generate-tests.ts	Adds test-generation instructions with typos
src/locators/locator-generation.ts	Returns only the first locator suggestion
examples/android-todo-app.md	Example doc with grammatical issues

Comments suppressed due to low confidence (4)

src/tools/interactions/click.ts:7

• The function is named generateTest but implements a click tool. Rename it to clickElement (or similar) to match the tool's purpose and default export.

export default function generateTest(server: FastMCP): void {

src/tools/interactions/screenshot.ts:6

• This tool has no parameters schema defined, which may lead to unexpected invocation errors. Consider adding parameters: z.object({}) for clarity.

server.addTool({

examples/android-todo-app.md:1

• [nitpick] The sentence is unclear and missing articles. Consider rephrasing to: 'Use the Appium generate-test tool to create an automation test for the following steps:'

Using appium  generate test tool create automation test for below step

src/locators/locator-generation.ts:209

• Changing from returning all sorted locators to only the first removes fallback options. If this is intentional, update function name or document the behavior; otherwise revert.

return [sortedLocators[0]];

[Copilot]

Validation logic in checkIsValidElementId is commented out, so all IDs pass. Consider re-enabling or removing the stubbed code to ensure proper UUID validation.