Skip to content

Add additional simple examples #193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
C-Loftus opened this issue May 18, 2025 · 1 comment
Open

Add additional simple examples #193

C-Loftus opened this issue May 18, 2025 · 1 comment
Labels
enhancement New feature or request

Comments

@C-Loftus
Copy link

C-Loftus commented May 18, 2025

Thank you for the work on this repo, it is super exciting! I have a feature request that hopefully would help new users in the community.

Is your feature request related to a problem? Please describe.

It would be helpful to have additional examples in the repo that are simpler and use very few direct dependencies. For instance, in the Python-mcp repo there are examples which only bring in 4 direct dependencies and in general use less code to demonstrate the features.

In the servers example folder the cargo.toml has 14 dependencies which makes it a bit tricky to adapt for new users since it is unclear which dependencies are needed.

Some of the examples use custom error types like anyhow::Result and it is not super clear to a user less familiar with the Rust ecosystem if this is a requirement or the preference of the maintainers. There is also tracing / logging code which may not be relevant for an example file.

I'd like to clarify that I think the existing examples are great, I just think there are ways to make it easier for newer users who are less familiar with the Rust ecosystem by adding a few more.

Describe the solution you'd like

I think the community would benefit from a very simple quickstart example that can be directly copy/pasted similar to the quickstart example for Python

It may be relevant as well to show the final, fully working file for the Quickstart section in the README

@C-Loftus C-Loftus added the enhancement New feature or request label May 18, 2025
@jokemanfire
Copy link
Collaborator

jokemanfire commented May 19, 2025

Firstly, I have decided to clearly display the necessary dependencies in the readme now,
Secondly, I plan to make modifications to the examples together when they are included in the integration testing.

Some of the examples use custom error types like anyhow::Result and it is not super clear to a user less familiar with the Rust ecosystem if this is a requirement or the preference of the maintainers. There is also tracing / logging code which may not be relevant for an example file.

At first, debug was included in the example for easy debugging because it was not yet stable. This will be modified in the future.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants