feat(mcp): add search server with advanced prompt engineering

closes #3

CHANGES
- Implement FastMCP server with search_py_dep_manager_docs tool
- Add Tantivy indexing script for documentation assets with metadata support
- Create comprehensive prompt engineering design with 3-iteration evolution
- Integrate progress transparency and mandatory citation requirements

IMPACT
- Users get continuous visibility into multi-call research progress
- All responses grounded in official documentation with authoritative citations
- Expert-level search assistance transforms perception from "slow tool" to "thorough research"

TECHNICAL NOTES
- Tantivy full-text search with fuzzy matching and package filtering
- GitHub link reconstruction from metadata for developer-friendly citations
- Adaptive content preview and query optimization based on user intent

Author: KemingHe

pyproject.toml

@@ -9,5 +9,6 @@ urls.repository = "https://github.com/KemingHe/python-dep-manager-companion-mcp-
 urls.issues = "https://github.com/KemingHe/python-dep-manager-companion-mcp-server/issues"
 dependencies = [
     "fastmcp>=2.10.5",
+    "pyyaml>=6.0.2",
     "tantivy>=0.24.0",
 ]

src/assets/conda/source/user-guide/configuration/settings.rst

@@ -22,7 +22,7 @@ Non-URL channels are interpreted as Anaconda.org user or organization
 names. You can change this by modifying the ``channel_alias`` as described
 in :ref:`set-ch-alias`. The default is just ``defaults``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -36,7 +36,7 @@ To select channels for a single environment, put a ``.condarc``
 file in the root directory of that environment (or use the
 ``--env`` option when using ``conda config``).
 
-**Example:** If you have installed Miniconda with Python 3 in your
+**Example**: If you have installed Miniconda with Python 3 in your
 home directory and the environment is named "flowers", the
 path may be::
 
@@ -111,7 +111,7 @@ can access, especially in enterprise or multi-user environments.
 
 The denylist takes precedence over the allowlist. If a channel is in both lists, it is denied.
 
-**Examples:**
+**Examples**:
 
 An example which allows the ``defaults`` and ``conda-forge`` channels with the ``allowlist_channels``
 setting is:
@@ -180,7 +180,7 @@ installs a package in the root environment. When ``False``,
 conda updates itself only if the user manually issues a
 ``conda update`` command. The default is ``True``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -195,7 +195,7 @@ Choose the ``yes`` option whenever asked to proceed, such as
 when installing. Same as using the ``--yes`` flag at the
 command line. The default is ``False``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -209,7 +209,7 @@ command line. The default is ``False``.
 Show channel URLs in ``conda list`` and when displaying what is
 going to be downloaded. The default is ``False``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -223,7 +223,7 @@ going to be downloaded. The default is ``False``.
 When using ``conda activate``, change the command prompt from ``$PS1``
 to include the activated environment. The default is ``True``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -238,7 +238,7 @@ Add pip, wheel, and setuptools as dependencies of Python. This
 ensures that pip, wheel, and setuptools are always installed any
 time Python is installed. The default is ``True``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -253,7 +253,7 @@ Use pip when listing packages with ``conda list``. This does not
 affect any conda command or functionality other than the output
 of the command ``conda list``. The default is ``True``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -348,7 +348,7 @@ which can be used to verify SSL connections:
 Filters out all channel URLs that do not use the ``file://``
 protocol. The default is ``False``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -374,7 +374,7 @@ specifying that certain files should never be soft linked.
 
 The default is ``False``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -407,7 +407,7 @@ is the same as::
 
 You can set ``channel_alias`` to your own repository.
 
-**Example:** To set ``channel_alias`` to your repository at
+**Example**: To set ``channel_alias`` to your repository at
 https://your.repo.com:
 
 .. code-block:: yaml
@@ -416,7 +416,7 @@ https://your.repo.com:
 
 On Windows, you must include a slash ("/") at the end of the URL:
 
-**Example:** https://your.repo/conda/
+**Example**: https://your.repo/conda/
 
 When ``channel_alias`` set to your repository at
 https://your.repo.com::
@@ -438,7 +438,7 @@ you create. You can override this option at the command prompt
 with the ``--no-default-packages`` flag. The default is to not
 include any packages.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -456,7 +456,7 @@ Enable certain features to be tracked by default. The default is
 to not track any features. This is similar to adding MKL to
 the ``create_default_packages`` list.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -480,7 +480,7 @@ set ``update_dependencies`` to ``True``.
 
 The default is ``False``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -507,7 +507,7 @@ better option may be to pin them. For more information, see
 Disallow the installation of certain packages. The default is to
 allow installation of all packages.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -528,7 +528,7 @@ automatically add the token to the channel URLs.
 
 The default is ``True``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -554,7 +554,7 @@ For each envs here, ``envs/pkgs`` is used as the pkgs cache,
 except for the standard ``envs`` directory in the root
 directory, for which the normal ``root_dir/pkgs`` is used.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -583,7 +583,7 @@ If the ``pkgs_dirs`` key is not set, then ``envs/pkgs`` is used
 as the pkgs cache, except for the standard ``envs`` directory in the root
 directory, for which the normal ``root_dir/pkgs`` is used.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -613,7 +613,7 @@ by setting the ``use_only_tar_bz2`` boolean to ``True``.
 
 The default is ``False``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -664,7 +664,7 @@ Build output root directory. You can also set this with the
 permissions to ``<CONDA_PREFIX>/conda-bld/``, the default is
 ``~/conda-bld/``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -703,7 +703,7 @@ Conda package version to create. Use ``2`` for ``.conda`` packages. If not set,
 Automatically upload packages built with conda-build to
 `Anaconda.org <http://anaconda.org>`_. The default is ``False``.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 

src/assets/conda/source/user-guide/configuration/use-condarc.rst

@@ -48,7 +48,7 @@ file, open a terminal and enter the ``conda config`` command.
 The ``.condarc`` configuration file follows simple
 `YAML syntax <https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html>`_.
 
-**Example:**
+**Example**:
 
 .. code-block:: yaml
 
@@ -73,7 +73,7 @@ home directory or root directory.
 To set configuration options, edit the ``.condarc`` file directly
 or use the ``conda config --set`` command.
 
-**Example:**
+**Example**:
 
 To set the ``auto_update_conda option`` to ``False``, run::
 

src/assets/conda/source/user-guide/install/rpm-debian.rst

@@ -76,7 +76,7 @@ key and add the conda repository to the sources list.
    # Add our Debian repo
    echo "deb [arch=amd64 signed-by=/usr/share/keyrings/conda-archive-keyring.gpg] https://repo.anaconda.com/pkgs/misc/debrepo/conda stable main" > /etc/apt/sources.list.d/conda.list
 
-   **NB:** If you receive a Permission denied error when trying to run the above command (because `/etc/apt/sources.list.d/conda.list` is write protected), try using the following command instead:
+   **NB**: If you receive a Permission denied error when trying to run the above command (because `/etc/apt/sources.list.d/conda.list` is write protected), try using the following command instead:
    echo "deb [arch=amd64 signed-by=/usr/share/keyrings/conda-archive-keyring.gpg] https://repo.anaconda.com/pkgs/misc/debrepo/conda stable main" | sudo tee -a /etc/apt/sources.list.d/conda.list
 
 Conda is ready to install on your Debian-based distribution.

src/assets/conda/source/user-guide/install/windows.rst

@@ -61,7 +61,7 @@ argument. The following optional arguments are supported:
 
 All arguments are case-sensitive.
 
-**Example:** The following command installs Miniconda for the
+**Example**: The following command installs Miniconda for the
 current user without registering Python as the system's default:
 
 .. code-block:: bat

src/assets/pip/html/ux-research-design/research-results/pip-search.md

@@ -53,18 +53,18 @@ Some users also mentioned that they would like the search to be configurable, e.
 
 When asked how they would improve pip search, users said they would improve:
 
-**1. Search methods:**
+**1. Search methods**:
 
 - fuzzy search and insensitive case should be acceptable
 - users should have the option to filter/sort by description, name, tag
 
-**2. Search results:**
+**2. Search results**:
 
 - relevancy: the results should show both the exact match and closest match
 - order/category: the result should display items in a certain order, e.g highest number of downloads (popularity), development status (last updated/latest version), etc.
 - there should be a limited number of search results
 
-**3. User interface:**
+**3. User interface**:
 
 - link package to pypi page
 - use color coding / system for better clarity

src/assets/poetry/repositories.md

@@ -531,7 +531,7 @@ required to set an empty password. This is supported by Poetry.
 poetry config http-basic.foo <TOKEN> ""
 ```
 
-**Note:** Empty usernames are discouraged. However, Poetry will honor them if a password is configured without it. This
+**Note**: Empty usernames are discouraged. However, Poetry will honor them if a password is configured without it. This
 is unfortunately commonplace practice, while not best practice, for private indices that use tokens. When a password is
 stored into the system keyring with an empty username, Poetry will use a literal `__poetry_source_empty_username__` as
 the username to circumvent [keyring#687](https://github.com/jaraco/keyring/pull/687).