How to contribute to LINE Bot MCP Server

First of all, thank you so much for taking your time to contribute! LINE Bot MCP Server is not very different from any other open source projects. It will be fantastic if you help us by doing any of the following:

• File an issue in the issue tracker to report bugs and propose new features and improvements.
• Ask a question using the issue tracker.
• Contribute your work by sending a pull request.

Development

You can freely fork the project, clone the forked repository, and start editing.

Install dependencies

Run npm install to install all dependencies for development.

Understand the project structure

The project structure is as follows:

• src: The main code.
• tools: The tools that can be used in the MCP server.
• common: The common code like utilities and types.

Add a new Tool

To add a new Tool, you can create a new file under src/tools/ and implement the Tool in that file. The Tool should extend AbstractTool and should be registered in src/index.ts. Please remember to add the description of the tool to both README.md and README.ja.md.

When adding a new tool, you also need to update the following tests:

1. Add a tool test file — Create test/tools/<yourTool>.test.ts.
2. Add mock methods if needed — If your tool calls a LINE API method not yet listed in test/helpers/mock-line-clients.ts, add it there.

Run tests

Run npm test to execute the test suite:

npm test

Tests are located in the test/ directory and use Vitest. LINE API calls are mocked using dependency injection — each tool class accepts a client in its constructor, so tests pass in stub objects created with vi.fn(). See test/helpers/mock-line-clients.ts for the mock factories.

Especially for bug fixes, please follow this flow for testing and development:

1. Write a test before making changes to the library and confirm that the test fails.
2. Modify the code of the library.
3. Run the test again and confirm that it passes thanks to your changes.

Run all CI tasks in your local

• npm run format: Format source code with Prettier
• npm run format:check: Silently run format and report formatting errors
• npm run build: Build TypeScript code into JavaScript. The built files will be placed in dist/.
• npm test: Run the test suite.

We lint, build, and test on CI, but it is always nice to check them before uploading a pull request.

Contributor license agreement

When you are sending a pull request and it's a non-trivial change beyond fixing typos, please make sure to sign the ICLA (individual contributor license agreement). Please contact us if you need the CCLA (corporate contributor license agreement).