docs(README): Migrate README from AsciiDoc to Markdown format

Author: codeboyzhou

README.adoc

@@ -0,0 +1,28 @@
+# MCP Server Examples
+
+Built using pure [MCP Java SDK](https://github.com/modelcontextprotocol/java-sdk) – No Spring Framework Required.
+
+For another easier way to develop your own MCP server, you can explore this [Annotation-driven MCP Java SDK](https://github.com/codeboyzhou/mcp-declarative-java-sdk).
+
+## Requirements
+
+- Java 17 or later (Restricted by MCP Java SDK)
+
+## What is MCP?
+
+The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) lets you build servers that expose data and functionality to LLM applications in a secure, standardized way. Think of it like a web API, but specifically designed for LLM interactions. MCP servers can:
+
+- Expose data through **Resources** (think of these sort of like GET endpoints; they are used to load information into the LLM's context)
+- Provide functionality through **Tools** (sort of like POST endpoints; they are used to execute code or otherwise produce a side effect)
+- Define interaction patterns through **Prompts** (reusable templates for LLM interactions)
+- And more!
+
+You can start exploring everything about **MCP** from [here](https://modelcontextprotocol.io).
+
+## Examples
+
+If you are looking for servers implemented with Typescript MCP SDK or Python MCP SDK, see [here](https://github.com/modelcontextprotocol/servers).
+
+These servers aim to demonstrate MCP features and the MCP Java SDK.
+
+- [Filesystem](https://github.com/codeboyzhou/mcp-java-sdk-examples/blob/main/mcp-server-filesystem/README.md) - Secure file operations with configurable access controls

README.md

@@ -1,57 +1,55 @@
-= Filesystem MCP Server
+# Filesystem MCP Server
 
 Java server implementing Model Context Protocol (MCP) for filesystem operations.
 
-== Features
+## Features
 
 - Read file from the local filesystem.
 - List files of a directory from the local filesystem.
 
-*Note*: The server will only allow operations within directories specified via `env`.
+**Note**: The server will only allow operations within directories specified via `env`.
 
-== API
+## API
 
-=== Resources
+### Resources
 
 - `file://system`: File system operations interface.
 
-=== Tools
+### Tools
 
-- *read_file*
-  * Read complete file contents with UTF-8 encoding.
-  * Input:
-    ** `path` (string): The filepath to read, required.
-  * Output: Complete file contents with UTF-8 encoding.
+- **read_file**
+  - Read complete file contents with UTF-8 encoding.
+  - Input:
+    * `path` (string): The filepath to read, required.
+  - Output: Complete file contents with UTF-8 encoding.
 
-- *list_files*
-  * List files of a directory.
-  * Input:
-    ** `path` (string): The directory path to read, required.
-    ** `pattern` (string): Regular expression to filter files, optional, default is empty, means no filter.
-    ** `recursive` (boolean): Whether to list files recursively, optional, default is `false`.
-  * Output: A list of file names (paths if 'recursive' is `true`), or empty string if no files found.
+- **list_files**
+  - List files of a directory.
+  - Input:
+    * `path` (string): The directory path to read, required.
+    * `pattern` (string): Regular expression to filter files, optional, default is empty, means no filter.
+    * `recursive` (boolean): Whether to list files recursively, optional, default is `false`.
+  - Output: A list of file names (paths if 'recursive' is `true`), or empty string if no files found.
 
-== Usage with MCP Client
+## Usage with MCP Client
 
 You can use any MCP client such as Cursor (IDE) or Cline (VS Code plugin) to interact with MCP server.
 
-=== Build
+### Build
 
-[source,bash]
-----
+```bash
 mvn clean package
-----
+```
 
-=== Configuration
+### Configuration
 
-*Note*: The `env` configuration is optional for access control.
+**Note**: The `env` configuration is optional for access control.
 
 `readable`: Read access control with regular expressions, format example: `["^/var/log/(app|sys)\.log$"]`.
 
 `writable`: Write access control with regular expressions, format example: `["^/var/log/(app|sys)\.log$"]`.
 
-[source,json]
-----
+```json
 {
   "mcpServers": {
     "mcp-server-filesystem": {
@@ -69,4 +67,4 @@ mvn clean package
     }
   }
 }
-----
+```