Merge pull request #3 from optuna/update-readme

Update `README.md` and `CONTRIBUTING.md`.

Author: HideakiImamura

CONTRIBUTING.md

@@ -4,6 +4,44 @@ If you are interested in contributing to Optuna MCP Server, please read the foll
 If you are new to GitHub, please refer to [our blog](https://medium.com/optuna/optuna-wants-your-pull-request-ff619572302c) for more information.
 
 
+## Setup Development Environment
+
+First of all, fork Optuna MCP on GitHub. You can learn about fork in the [official documentation](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo).
+
+After forking, download and install Optuna MCP on your computer as follows:
+
+```
+$ git clone [email protected]:YOUR_NAME/optuna-mcp.git
+$ cd optuna-mcp
+$ uv sync   # Install dependencies
+$ pwd       # Check the path to your optuna-mcp directory.
+/PATH/TO/optuna-mcp
+$ which uv  # Check the path to your uv binary.
+/PATH/TO/uv
+```
+
+After the installation, configure the MCP client (e.g., Claude Desktop) as explained in the [README.md](README.md#installation).
+Please fill the placeholders of path to your uv binary and optuna-mcp directory:
+
+```json
+{
+  "mcpServers": {
+    "Optuna": {
+      "command": "/PATH/TO/uv",
+      "args": [
+        "--directory",
+        "/PATH/TO/optuna-mcp",
+        "run",
+        "optuna-mcp"
+        "--storage",
+        "sqlite:///optuna.db"
+      ],
+    }
+  }
+}
+```
+
+
 ## Coding Standards and Guidelines
 
 Please adhere to the following coding standards and guidelines:

README.md

@@ -3,32 +3,34 @@
 [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue)](https://www.python.org)
 [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/optuna/optuna-mcp)
 
-The Optuna MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server to interact with Optuna APIs.
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that automates optimization and anlysis using [Optuna](http://optuna.org).
 
 <img width="840" alt="image" src="./examples/sphere2d/images/sphere2d-6.png" />
 
 ## Use Cases
 
-- Hyperparameter Optimization driven by LLMs
-- Interactive analysis of Optuna's optimization history
+The Optuna MCP Server can be used in the following use cases, for example.
 
+- Automated hyperparameter optimization by LLMs
+- Interactive analysis of Optuna's optimization results via chat interface
+- Optimize input and output of other MCP tools
 
-## Prerequisites
-
-Before starting the installation process, ensure to:
-
-1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/)
-2. After installing `uv`, execute the command `uv python install 3.12` to install Python 3.12 or a newer version.
-3. Lastly, add the server to your MCP client configuration.
+For details, see the [Examples section](#examples).
 
 ## Installation
 
-### Usage with Claude Desktop
-
 <!-- TODO(c-bata): Remove the following line after publishing to the PyPI and DockerHub-->
 
 *Please note that `optuna-mcp` does not exist on PyPI and DockerHub at the moment.*
 
+The Optuna MCP server can be installed using `uv` or Docker.
+This section explains how to install the Optuna MCP server, using Claude Desktop as an example MCP client.
+
+### Usage with uv
+
+Before starting the installation process, install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/).
+
+Then, add the Optuna MCP server configuration to the MCP client.
 To include it in Claude Desktop, go to Claude > Settings > Developer > Edit Config > `claude_desktop_config.json`
 and add the following:
 
@@ -37,48 +39,21 @@ and add the following:
   "mcpServers": {
     "Optuna": {
       "command": "uvx",
-      "args": [
-        "optuna-mcp",
-        "--storage",
-        "sqlite:///optuna.db"
-      ],
+      "args": ["optuna-mcp"],
     }
   }
 }
 ```
 
-After adding this, please restart Claude Desktop application.
-For more information about Claude Desktop, check out [the quickstart page](https://modelcontextprotocol.io/quickstart/user).
-
-### Build from source
-
-<!-- TODO(c-bata): Change the git url after published to under the optuna org. -->
-
-For those who are interested in the version under development, you can manually clone the repository
-and install its dependencies as follows:
-
-```
-$ git clone [email protected]:optuna/optuna-mcp.git
-$ cd optuna-mcp
-$ uv sync   # Install dependencies
-$ pwd       # Check the path to your optuna-mcp directory.
-/PATH/TO/optuna-mcp
-$ which uv  # Check the path to your uv binary.
-/PATH/TO/uv
-```
-
-After cloning, include the path to your uv binary and optuna-mcp directory in your configuration as follows:
+Additionally, you can specify the Optuna storage with the `--storage` argument to persist the results.
 
 ```json
 {
   "mcpServers": {
     "Optuna": {
-      "command": "/PATH/TO/uv",
+      "command": "uvx",
       "args": [
-        "--directory",
-        "/PATH/TO/optuna-mcp",
-        "run",
-        "optuna-mcp"
+        "optuna-mcp",
         "--storage",
         "sqlite:///optuna.db"
       ],
@@ -87,7 +62,11 @@ After cloning, include the path to your uv binary and optuna-mcp directory in yo
 }
 ```
 
+After adding this, please restart Claude Desktop application.
+For more information about Claude Desktop, check out [the quickstart page](https://modelcontextprotocol.io/quickstart/user).
+
 ### Usage with Docker
+
 You can also run the Optuna MCP server using Docker. Make sure you have Docker installed and running on your machine.
 
 ```json
@@ -111,7 +90,11 @@ You can also run the Optuna MCP server using Docker. Make sure you have Docker i
 }
 ```
 
-## Tools
+## Tools provided by Optuna MCP
+
+The Optuna MCP provides the following tools.
+Specifically, it offers primitive functions of Optuna such as Study, Trial, Visualization, and Dashboard.
+Since MCP clients know the list of tools and the details of each tool, users do not need to remember those details.
 
 ### Study