times_esa_mcp_server リポジトリの概要

What is times_esa_mcp_server?

times_esa_mcp_server is a Model Context Protocol (MCP) server that allows you to create and manage daily reports and posts on esa.io directly from within VS Code. It is designed for developers who want to take notes or post daily reports without leaving their editor.

How to use times_esa_mcp_server?

Install the server with go install github.com/syou6162/times_esa_mcp_server, set the environment variables ESA_TEAM_NAME and ESA_ACCESS_TOKEN (with read and write permissions), then configure VS Code's settings.json to point to the binary. Use the #times-esa command to post.

Key features of times_esa_mcp_server

• Post daily reports to esa.io using the #times-esa command
• Automatically manages reports under the "日報/YYYY/MM/DD" category
• Appends current time with anchor links for easy navigation
• Updates existing reports by appending content at the top
• Includes debounce to prevent duplicate posts based on text similarity

Use cases of times_esa_mcp_server

• Quickly jot down ideas or questions that arise during development
• Record daily work progress without switching away from VS Code
• Maintain time-stamped logs for personal or team retrospectives

FAQ from times_esa_mcp_server

What dependencies or runtime are required?

The server is implemented in Go 1.23.2 and uses the mark3labs/mcp-go framework. You need Go installed to build from source, or you can use the prebuilt binary.

Where does my data live?

All reports are stored on esa.io under your configured team’s workspace. The server only communicates with esa.io’s API and does not persist data locally.

What permissions are needed for the access token?

The ESA_ACCESS_TOKEN must have both read and write permissions.

How does the server handle duplicate posts?

It implements a debounce mechanism that considers text similarity to avoid posting the same content multiple times.

Can I use this server outside VS Code?

The README only describes usage via VS Code’s MCP configuration. It is built on the MCP protocol, so it could theoretically be used with other MCP clients, but only VS Code integration is documented.